API Reference
Use Crawlora's The RealReal API endpoints to extract supported public The RealReal data as structured JSON. This documentation covers 11 active endpoints including Get The RealReal search-box suggestions, Get The RealReal category browse taxonomy, Browse The RealReal listings by category, Browse The RealReal listings by curated collection, and related APIs. Developers can use these endpoints for monitoring, enrichment, research dashboards, internal data pipelines, and agent-native workflows without maintaining platform-specific scraping code. Each endpoint page documents authentication, request parameters such as term, path, slug, url, cURL examples, response examples, response schemas, errors, credit cost, and Playground testing. Send requests to the Crawlora API with an x-api-key header, review usage and plan limits on pricing, and test safe sample requests in Playground before moving the workflow into production.
Choose an endpoint, send an authenticated request with the x-api-key header, and inspect the normalized JSON response. The examples below use the public Crawlora API base URL and the same endpoint catalog used by Playground.
curl -X GET "https://api.crawlora.net/api/v1/therealreal/search?query=coffee&on_sale=true&available=true" \
-H "x-api-key: $CRAWLORA_API_KEY"These endpoint cards are generated from the active Crawlora endpoint catalog, including method, path, auth mode, credit cost, parameter summary, docs, and Playground links.
/therealreal/autocompleteapiKey4 credits/requestReturns The RealReal's own search-box typeahead suggestions for a partial query. Credential-free public data sourced from The RealReal's own first-party catalog API.
Required params: term:query
/therealreal/categoriesapiKey2 credits/requestReturns The RealReal's full category (taxon) browse taxonomy: every department, category, and subcategory, nested, with each entry's id (usable directly against search's category_id), permalink (usable directly against the category endpoint's path), and live matching item count. This is reference data that changes rarely, so responses are cached. Credential-free public data sourced from The RealReal's own server-rendered category page.
Required params: None
/therealreal/categoryapiKey4 credits/requestReturns a page of normalized The RealReal listings browsed by category (taxon) permalink path, e.g. women/handbags. Pass a previous response's next_after back as after to fetch the next page. Credential-free public data sourced from The RealReal's own server-rendered category page.
Required params: path:query
/therealreal/collectionapiKey4 credits/requestReturns a page of normalized The RealReal listings browsed by curated collection slug, e.g. on-sale-now -- sale campaigns, editor's picks, and similar merchandising collections distinct from category/designer browsing. Pass a previous response's next_after back as after to fetch the next page. Credential-free public data sourced from The RealReal's own server-rendered collection page.
Required params: slug:query
/therealreal/collectionsapiKey2 credits/requestReturns The RealReal's full published set of curated editorial and sale-campaign collection slugs (e.g. on-sale-now, hermes-birkin-bag), each usable directly against the collection endpoint's own slug field. This is reference data that changes rarely, so responses are cached. Credential-free public data sourced from The RealReal's own published sitemap.
Required params: None
/therealreal/conditionsapiKey2 credits/requestReturns The RealReal's full authentication condition-grading scale: the closed 6-tier set (Pristine, Excellent, Very Good, Good, Fair, As Is) it defines, each with an id (usable directly against search's condition_id) and live matching item count. This is reference data that changes rarely, so responses are cached. Credential-free public data sourced from The RealReal's own server-rendered category page.
Required params: None
/therealreal/designerapiKey4 credits/requestReturns a page of normalized The RealReal listings browsed by designer slug, e.g. gucci. Pass a previous response's next_after back as after to fetch the next page. Credential-free public data sourced from The RealReal's own server-rendered designer page.
Required params: slug:query
/therealreal/designersapiKey2 credits/requestReturns every designer The RealReal recognizes in one department (not just designers with currently active listings), each with an id (usable directly against search's designer_id) and slug (usable directly against the designer endpoint). The directory is segmented by department -- pass category to select one; the response's categories field lists every accepted value. This is reference data that changes rarely, so responses are cached. Credential-free public data sourced from The RealReal's own server-rendered designer directory page.
Required params: None
/therealreal/listingapiKey4 credits/requestReturns a single normalized The RealReal listing: description, condition detail, category context, and measurements, plus the shared summary fields (name, designer, condition, price, images). Looked up by the listing's full product URL, as returned in a search/category/designer response's url field. Credential-free public data sourced from The RealReal's own server-rendered listing page.
Required params: url:query
/therealreal/searchapiKey4 credits/requestSearches The RealReal's authenticated luxury resale catalog by keyword, optionally combined with category, designer, condition-grade, and price-range filters, returning normalized listing summaries (name, designer, condition, price, images) plus the total matching count and an opaque pagination cursor. Pass a previous response's next_after back as after to fetch the next page. Credential-free public data sourced from The RealReal's own server-rendered search page.
Required params: query:query
/therealreal/similarapiKey4 credits/requestReturns The RealReal's own "Similar Items" visual-similarity recommendations for one product, looked up by the product's numeric id (from any other The RealReal endpoint's listing response id field). Credential-free public data sourced from The RealReal's own first-party catalog API.
Required params: product_id:query
| Endpoint | API path | Method | Credits | Required params | Docs | Playground |
|---|---|---|---|---|---|---|
| Get The RealReal search-box suggestions | /therealreal/autocomplete | GET | 4 credits/request | term:query | View docs | Try endpoint |
| Get The RealReal category browse taxonomy | /therealreal/categories | GET | 2 credits/request | None | View docs | Try endpoint |
| Browse The RealReal listings by category | /therealreal/category | GET | 4 credits/request | path:query | View docs | Try endpoint |
| Browse The RealReal listings by curated collection | /therealreal/collection | GET | 4 credits/request | slug:query | View docs | Try endpoint |
| Get The RealReal curated collection slugs | /therealreal/collections | GET | 2 credits/request | None | View docs | Try endpoint |
| Get The RealReal condition-grading value space | /therealreal/conditions | GET | 2 credits/request | None | View docs | Try endpoint |
| Browse The RealReal listings by designer | /therealreal/designer | GET | 4 credits/request | slug:query | View docs | Try endpoint |
| Get The RealReal designer directory | /therealreal/designers | GET | 2 credits/request | None | View docs | Try endpoint |
| Get a The RealReal listing detail | /therealreal/listing | GET | 4 credits/request | url:query | View docs | Try endpoint |
| Search The RealReal luxury consignment listings | /therealreal/search | GET | 4 credits/request | query:query | View docs | Try endpoint |
| Get The RealReal similar-item recommendations | /therealreal/similar | GET | 4 credits/request | product_id:query | View docs | Try endpoint |