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.
Browse a category, a designer, a curated sale or any filter combination without a keyword — the catalogue view. Same row shape and sorts as `search`. At least one of category, category_id, designer, designer_id, sale_slug or a facet filter is required, so nobody accidentally pages through four million rows.
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.
A curated sale/collection slug, e.g. 'hermes-birkin-bag'. `search` reports one in `redirect_to_sale` when the site answers a query with a curated page.
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/browse \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"category":"women/handbags","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 |