Try any of 3860 endpoints — live.
Pick an endpoint, load a working example, tweak the params, and send — no signup to try. Results render the way the data deserves; raw JSON, headers & code are one tab away.
Keyword search across the live catalogue with every filter the site exposes (category, designer, condition grade, colour, size, gender, store, price range, on-sale, vintage, with-tags, editors' picks) and its own sorts. Each row carries the asking price, the original retail estimate where the source publishes one, the condition grade, sold flag and images. Some brand/model terms ('birkin', 'kelly bag') are answered by the site with a curated collection instead of results — this action follows that redirect and says so in `followed_redirect`.
Free-text search, e.g. 'chanel classic flap'.
Display currency for the *_display fields. Prices are ALSO always returned in USD, because the source converts the label only.
1-based page. The catalogue connection stops at 2000 rows. (1–)
Rows per page, 1-120 (the source's own ceiling). (1–120)
Result order.
Follow the site's curated-collection redirect when a query returns one (default true). Set false to receive the redirect target untouched.
Category permalink, e.g. 'women/handbags', 'men/shoes', 'jewelry/earrings', 'watches/bracelet'. Call `categories` for the live tree.
Category facet id(s) from `filters`/`categories`.
Designer slug, e.g. 'chanel', 'saint-laurent', 'louis-vuitton'. Call `designers` for the full index.
Designer facet id(s) (from `designers`).
Condition grade(s) the site assigns. A numeric facet id is also accepted.
Colour / pattern facet(s).
Gender facet.
Clothing size(s) (XS…5XL, Petite).
US shoe size(s), 3.5-18.
Physical-store id(s) — items available in that TheRealReal store. `filters` lists them.
Minimum asking price in USD. (0–)
Maximum asking price in USD. (0–)
'available' hides sold listings (default); 'all' keeps them. Sold items are a real state on a one-of-a-kind marketplace, not an error.
Only items the site currently marks as marked down.
Only items flagged vintage.
Only items still carrying their original tags.
Only editors' picks.
curl -X POST https://api.reefapi.com/therealreal/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"chanel classic flap","page_size":"24"}'Press Send request to see the live result here.
Not sure what to send? Ask Reef AIWhat you can run here, without an account
ReefAPI is one HTTP gateway to 632 live web-data APIs covering 3860 endpoints across 13 categories. Every endpoint answers with the same JSON envelope, so one integration reaches all of them. Each response reports what it cost and when the source was read.
No signup, no API key and no card are required to try an endpoint on this page. Anonymous calls run on a shared demo key, capped at 15 calls per hour per visitor. Pick an API, fill the parameters and the real response comes back from the live source, not from a canned sample. A free account lifts the cap and gives you 1,000 credits and your own key.
Browse every API in the catalog, read an endpoint's fields and example response in the docs, or see per-call credit costs on the pricing page.
Coverage by category
| ecommerce | 350 |
| classifieds | 116 |
| real-estate | 29 |
| media | 25 |
| utilities | 18 |
| jobs | 18 |
| developer-tools | 18 |
| reviews | 15 |
| social | 15 |
| search-seo | 11 |
| travel | 8 |
| other | 5 |
| finance | 4 |