Every Micolet garment, available or already sold — on eight storefronts that each price the same piece separately
The Micolet API returns micolet.com — the Spanish managed second-hand fashion marketplace for women, men and kids — as clean JSON in five actions: search, detail, seller, brands and categories.
5 active endpoints, on 1, 2 and 3 credit tiers.
- POST/micolet/v1/search
- POST/micolet/v1/detail
- POST/micolet/v1/seller
- POST/micolet/v1/brands
- POST/micolet/v1/categories
What Micolet endpoints does ReefAPI ship?
5 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
Micolet API
4 of 5 endpoints, ready to run
Search or browse one Micolet storefront and department, 48 rows per page: each garment with brand, type, colour codes, letter and numeric size, condition grade, season, the printed price, the euro list price, the original retail price and whether it is already sold. The response carries the site's own total, available and sold counts.
// Press "Try it" and this pane shows exactly what the // live site returned this second — including an empty // result, if that is the truth. No key, no account.
How the Micolet API works
Micolet is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 491 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and cache hits cost nothing.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
Find a garment, check what similar pieces sold for, then buy it where it is cheapest
Micolet keeps sold garments listed with their last price and prices the same piece differently on each storefront. A few calls take you from a brand name to the cheapest country for one item.
Get the brand id: Levi's is 19.
Available rows come first, sold rows after, each flagged is_sold with its price; the response says how many of each exist (20,725 total, 1,532 available on the day).
Every photo, the original retail price, the discount, availability and the closet it came from.
The same garment on another storefront: each one prices it separately (median over Spain: DE/UK +18.9%, IT/PL +33.9%). Repeat per market you care about; each response states its market and currency.
A sold-price reference for the brand, the full record of one available garment, and its price on each storefront you asked for, showing where it is cheapest — all from Micolet's own pages, with the site's own counts.
curl -X POST https://api.reefapi.com/micolet/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"market":"ES","category":"3","condition":"new"}'{
"ok": true,
"data": { … },
"meta": {
"api": "micolet",
"endpoint": "search",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}One garment, priced on all eight Micolet storefronts
Item 8417448, a casual dress in size M, good condition, read on 2026-10-14. Each storefront keeps its own euro price; the UK and Poland display theirs converted at one rate. Each row is one detail call with that market; every response names the market and currency it was read on.
| storefront | printed price | euro list price | vs Spain |
|---|---|---|---|
| ES · micolet.com | 9.49 EUR | 9.49 | — |
| PT · micolet.pt | 9.99 EUR | 9.99 | +5.3% |
| FR · micolet.fr | 9.99 EUR | 9.99 | +5.3% |
| BE · micolet.be | 10.49 EUR | 10.49 | +10.5% |
| DE · micolet.de | 10.99 EUR | 10.99 | +15.8% |
| GB · micolet.co.uk | £9.28 | 10.99 | +15.8% |
| IT · micolet.it | 12.49 EUR | 12.49 | +31.6% |
| PL · micolet.pl | 54.67 zł | 12.49 | +31.6% |
Measured to depend on the storefront only: the same item read from different networks and countries returned the same price on micolet.com, micolet.co.uk and micolet.pl. Reduced items are the exception to the per-country markup — a marked-down dress carried the same 5.87 EUR on the Spanish and UK storefronts.
What Micolet publishes, measured on 2026-10-14
Every figure came out of this API or its recon on one day.
8 — Spain (micolet.com), France, Belgium, Portugal, United Kingdom (GBP), Italy, Germany, Poland (PLN)
women 7,334,817 · men 576,039 · kids 411,459 garments, sold included (Spain)
women 530,130 available of 7,334,806; dresses 102,329 of 1,149,515 — the rest are sold and still listed
15 category ids shared by the three departments, with sub-type tags
11, each measured against the unfiltered total in the same run
median markup over Spain: PT +5.1%, FR +8.8%, BE +14.3%, DE and UK +18.9%, IT and PL +33.9% (12 dresses on all 8 storefronts)
search price vs the item's own page: 8 of 8 matched in amount and currency (EUR, GBP, PLN)
48 rows per page, 100 pages (4,800 rows) per query
photos (standard + zoom), size, colour, season, condition grade, printed / euro list / original / pre-markdown price, discount, availability, seller closet
sort order, per-item measurements, flaw descriptions, stock counts
What people build with Micolet
The jobs this data is most often used for.
endpoints
credits per call
Compare what the same second-hand garment costs on Micolet's storefronts by calling detail with each market, and buy where it is cheapest.
Use Micolet's sold listings, with their last prices, as evidence of what second-hand items of a brand and size actually sold for.
Track a brand's available versus sold second-hand supply per category and country using the site's own counts.
Follow a seller's closet: its available and sold garments, filtered by colour, size or price.
What Micolet data costs
The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.
Full pricing →- 1,000 free credits on signup, no card
- One key, all 491 APIs, one credit pool
- Failed and blocked calls are never charged
- Credits roll over and never expire
Call it in two lines
Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.
curl -X POST https://api.reefapi.com/micolet/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"market":"ES","category":"3","condition":"new"}'import requests
r = requests.post(
"https://api.reefapi.com/micolet/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"market": "ES",
"category": "3",
"condition": "new"
},
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up Micolet.
Get a free key →Does the API return sold items?▾
Yes, because Micolet lists them. Its category pages show available garments first and sold ones after, and the headline count is mostly sold: 1,149,515 dresses on one day, 102,329 of them available. Every row carries is_sold, the response carries the site's three counts (total, available, sold), and exclude_sold drops the sold rows if you only want what can be bought. A sold garment's detail page still returns its last price.
Is the price the same on every Micolet storefront?▾
No. Each of the eight storefronts keeps its own euro price list. Across twelve dresses listed on all eight, the median markup over Spain was +5.1% in Portugal, +8.8% in France, +14.3% in Belgium, +18.9% in Germany and the UK and +33.9% in Italy and Poland. The UK and Poland display their euro price in pounds and zloty at one exchange rate. Reduced items carry the same euro price everywhere. To compare, call detail on the same item_id with each market you care about.
What is price_eur_list next to price?▾
price is what the storefront prints, in its own currency. price_eur_list is the storefront's euro list price that the printed one is derived from. On the six euro storefronts they are equal; on the UK and Polish storefronts the printed price is the euro list price converted (one dress: 10.99 euro list, printed £9.28 and, in Poland, 12.49 euro list, printed 54.67 zł).
Which filters can I use?▾
Department (women, men, kids), category, sub-type tag, brand id, colour, letter size, numeric size, condition (new with tags or small defect), season, a price range and free text. Each was measured against the unfiltered total in the same run — for example dresses 1,149,513, red ones 88,921, new-with-tags ones 146,370. The price range is in the storefront's own currency, and free text is matched in the storefront's language.
How deep can I page?▾
48 rows per page, up to page 100 — 4,800 rows per query. Micolet returns empty pages after that, so the API refuses a page above 100 and reports the last page and whether there is more. Narrow the filters to reach further.
Who is the seller?▾
Micolet sells and ships every item, and the item page also names the private seller's closet the garment came from. detail returns that closet's id and name, and seller opens the closet with its own counts — one measured closet held 1,146 garments, 128 of them available. Items from influencer closets are marked as such.
Can I sort results?▾
No. Micolet's storefront has no sort control, so rows come in the site's own order: available garments first, then sold ones. Filter instead, or sort the rows you receive.
Does it return measurements or a description of flaws?▾
No, because Micolet does not publish them per item. The condition is a grade — new with tags, good condition or small defect — and the photos show the piece. The hanger-measurements link on the site opens a general guide, not the garment's own measurements.
What is the Micolet API?▾
Micolet API is a ReefAPI endpoint group for spain's managed second-hand fashion marketplace as json: one-of-a-kind garments graded and priced by micolet, sold items included with their last price, and each of the eight european storefronts with its own price. It returns live JSON through POST requests under /micolet/v1.
Is the Micolet API free to try?▾
Yes. ReefAPI starts with 1,000 free credits, no card required. Micolet calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Micolet login or account?▾
No login to Micolet is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Micolet data?▾
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Micolet API use?▾
Micolet actions currently cost 1-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Micolet from an AI assistant or MCP client?▾
Yes. Connect ReefAPI once through MCP and your assistant can call micolet actions with the same key, credit pool and JSON envelope used by normal REST requests.
231 E-commerce & Marketplaces APIs on the same key
One key, one credit pool, one response envelope. If you are pulling Micolet, you are one call away from the rest of the category — no second contract, no second integration.
Need something this API does not do?
Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.
Try it on your own data before you pay anything
The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 490 APIs, and the same envelope everywhere.
Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-10-14.