API Reference
Search The RealReal's authenticated luxury consignment catalog, browse by category or designer, and get listing and condition-grade detail as structured JSON. 11 endpoints documented below.
curl "https://api.crawlora.net/api/v1/therealreal/search?query=gucci+bag" \
-H "x-api-key: $CRAWLORA_API_KEY"/therealreal/autocompleteapiKey4 credits/requestReturns The RealReal's own search-box typeahead suggestions for a partial query.
Required: term.
Sampled 14 Oct 2026: 20 items. Filled in every item: text. In the sample: text: “gucci” and 19 other values.
/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.
Takes no parameters.
Sampled 14 Oct 2026: 8 items. Filled in every item: id, name, permalink, count, children. In the sample: count: 11 to 2,228,269, median 11,042; name: “Women” and 7 other values; children: median 4 entries; permalink: “women” and 7 other values.
/therealreal/categoryapiKey4 credits/requestReturns a page of 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.
Required: path. Optional: on_sale, available, after.
Sampled 14 Oct 2026: 120 items. Filled in every item: id, name, sku, designer, condition, color, gender, price_usd and 5 more. In the sample: condition: Very Good (58), Good (31), Excellent (18) and 2 more; price_usd: 95 to 8,895, median 775; name: “Zucca FF Vintage Brown Handle Bag” and 100 other values; image_url: product-images.therealreal.com; available: true in 107 of 120; images: median 6 entries; designer: “Fendi” and 45 other values; color: “Brown” and 14 other values.
/therealreal/collectionapiKey4 credits/requestReturns a page of 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.
Required: slug. Optional: after.
Sampled 14 Oct 2026: 120 items. Filled in every item: id, name, sku, designer, condition, price_usd, original_price_usd, available and 3 more. Not in every item: color (115), gender (97). In the sample: condition: Pristine (80), Excellent (18), Very Good (14) and 2 more; price_usd: 15 to 1,087.75, median 120; name: “Floral Print Midi Length Dress” and 101 other values; image_url: product-images.therealreal.com; available: true in 119 of 120; images: median 3 entries; designer: “Reformation” and 69 other values; color: “Green” and 16 other values.
/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.
Takes no parameters.
Sampled 14 Oct 2026: 542 items. Not in every item: slug (500), url (500). In the sample: url: therealreal.com.
/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.
Takes no parameters.
Sampled 14 Oct 2026: 6 items. Filled in every item: id, name, count. In the sample: count: 3,906 to 116,357, median 19,219; name: “Pristine” and 5 other values.
/therealreal/designerapiKey4 credits/requestReturns a page of 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.
Required: slug. Optional: on_sale, available, after.
Sampled 14 Oct 2026: 120 items. Filled in every item: id, name, sku, designer, condition, price_usd, original_price_usd, available and 3 more. Not in every item: color (119), gender (108). In the sample: condition: Very Good (46), Good (34), Excellent (19) and 2 more; price_usd: 115 to 2,400, median 525; name: “Silk Mini Dress” and 104 other values; image_url: product-images.therealreal.com; available: true in 117 of 120; images: median 5 entries; color: “Orange” and 11 other values; original_price_usd: 115 to 2,400, median 525.
/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.
Optional: category.
Sampled 14 Oct 2026: 5422 items. Not in every item: id (500), name (500), slug (500). In the sample: name: “032c” and 499 other values.
/therealreal/listingapiKey4 credits/requestReturns a single 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.
Required: url.
Sampled 14 Oct 2026: 19 fields returned with a value. In the sample: price_usd: 3,800; name: “Denim Pearl Crush Wallet On Chain”; image_url: product-images.therealreal.com; available: false; description: 263 characters; images: 4 entries; designer: “Chanel”; condition: “Very Good”.
/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 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.
Required: query. Optional: category_id, designer_id, condition_id, price_from, price_to, on_sale, available, after.
Sampled 14 Oct 2026: 120 items. Filled in every item: id, name, sku, designer, condition, gender, price_usd, original_price_usd and 4 more. In the sample: condition: Good (38), Fair (26), As Is (19) and 3 more; price_usd: 126 to 6,400, median 436; name: “GG Canvas Shoulder Bag” and 98 other values; image_url: product-images.therealreal.com; available: true in 117 of 120; images: median 6 entries; original_price_usd: 165 to 8,000, median 565; url: therealreal.com.
/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).
Required: product_id.
Sampled 14 Oct 2026: 14 items. Filled in every item: id, name, sku, designer, designer_slug, price_usd, original_price_usd, available and 3 more. In the sample: price_usd: 2,166.5 to 8,000, median 3,905.75; name: “Denim Pearl Crush Wallet On Chain” and 12 other values; image_url: product-images.therealreal.com; available: true in 14 of 14; images: median 6 entries; original_price_usd: 2,645 to 8,000, median 4,000; url: therealreal.com.
Results from the 7 days to 13 Oct 2026. Current status
| Endpoint | Request | Checks passed | Median response |
|---|---|---|---|
| Get The RealReal search-box suggestions | GET /therealreal/autocomplete?term=gucci | 99.9% | 1.23 s |
| Get The RealReal category browse taxonomy | GET /therealreal/categories | 100% | 0.32 s |
| Browse The RealReal listings by category | GET /therealreal/category?path=women%2Fhandbags | 99.8% | 3.22 s |
| Browse The RealReal listings by curated collection | GET /therealreal/collection?slug=on-sale-now | 99.9% | 2.97 s |
| Get The RealReal curated collection slugs | GET /therealreal/collections | 99.9% | 0.27 s |
| Get The RealReal condition-grading value space | GET /therealreal/conditions | 100% | 0.18 s |
| Browse The RealReal listings by designer | GET /therealreal/designer?slug=gucci | 99.4% | 2.77 s |
| Get The RealReal designer directory | GET /therealreal/designers?category=women | 100% | 0.98 s |
| Get a The RealReal listing detail | GET /therealreal/listing?url=https%3A%2F%2Fwww.therealreal.com%2Fproducts%2Fwomen%2Fhandbags%2Fcrossbody-bags%2Fchanel-denim-pearl-crush-wallet-on-chain-wdqhu | 99.9% | 1.90 s |
| Search The RealReal luxury consignment listings | GET /therealreal/search?query=gucci+bag | 99.9% | 3.01 s |
| Get The RealReal similar-item recommendations | GET /therealreal/similar?product_id=54388578 | 99.9% | 2.05 s |