Authenticated luxury consignment pricing research
The RealRealエンドポイントを使えば、「Authenticated luxury consignment pricing research」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
Turn The RealReal's public authenticated luxury consignment catalog into structured JSON — keyword search with category, designer, condition-grade, and price-range filters, direct category and designer browsing, full listing detail with measurements and condition notes, the complete department/category taxonomy, the 5,000-plus-designer directory, and the 6-tier authentication condition scale. Normalized JSON, credential-free.
Search The RealReal's authenticated luxury consignment catalog, browse by category or designer, and get listing and condition-grade detail as structured JSON.
エンドポイントファミリー
6
ドキュメント化されたパラメータ
34
サンプル数
11
ライブカタログスナップショット
稼働エンドポイント
11
メソッド
GET
必須パラメータ
18
スキーマ参照
11
{
"platform": "The RealReal",
"endpoint": "therealreal-search",
"method": "GET",
"path": "/therealreal/search",
"auth": "apiKey"
}ユースケース
Search The RealReal's authenticated luxury consignment catalog, browse by category or designer, and get listing and condition-grade detail as structured JSON.
The RealRealエンドポイントを使えば、「Authenticated luxury consignment pricing research」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
The RealRealエンドポイントを使えば、「Condition-grade and designer demand tracking」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
The RealRealエンドポイントを使えば、「Category and designer coverage monitoring」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
マネージド実行
以下の数値はすべて、稼働中のThe RealRealエンドポイントカタログから取得しています（エンドポイント11件、ドキュメント化されたリクエストパラメータ34個、公開レスポンススキーマ11件）。DocsとPlaygroundが参照しているカタログと同じものです。
The RealRealのエンドポイントは11件、11つのリクエストファミリーに分類されています（Autocomplete、Categories、Categoryほか8件）。
これらのThe RealRealエンドポイントには34個のリクエストパラメータがドキュメント化されており、うち18個が必須です。統合コードを書く前に入力仕様をすべて確認できます。
11件のThe RealRealエンドポイントのうち11件が実際のサンプルレスポンスを、11件がドキュメント化されたレスポンススキーマを備えています。最初のリクエストの前に実データの形に合わせて実装できます。
The RealRealのエンドポイントは成功時のスキーマに加えてエラーレスポンス（400、404、500、503）もドキュメント化しています。ブロック、レート制限、レコード欠損は空データではなく型付きのエラーとして返ります。
The RealRealのエンドポイントは11個のホスト型MCPツールとして提供されており、エージェントは同じパラメータと同じJSON契約のまま、追加の実装なしに同じルートを呼び出せます。
カバレッジマップ
/therealreal/autocomplete
/therealreal/categories
/therealreal/category
/therealreal/collection
/therealreal/collections
/therealreal/conditions
エンドポイントカタログ
/therealreal/searchSearches 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.
レスポンスに関する注記
- `total` reflects The RealReal's full matching-result count for the applied filters, not just `len(listings)`. - `next_after` is an opaque, server-issued pagination cursor. Pass it back as `after` (with the same `query`/filters) to fetch the next page. `has_more` is `false` once there is nothing further to page through. - A search with no matching listings returns `200` with `"listings": []`. - A missing `query` returns `400` before any upstream request is made. - `price_from` greater than `price_to` returns `400`.
MCPツール therealreal_search
/therealreal/categoryReturns 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.
レスポンスに関する注記
- Response shape matches [search](therealreal-search.md): `total`, `has_more`, `next_after`, `listings`. - An unrecognized `path` returns `404`.
MCPツール therealreal_category
/therealreal/designerReturns 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.
レスポンスに関する注記
- Response shape matches [search](therealreal-search.md): `total`, `has_more`, `next_after`, `listings`. - An unrecognized `slug` returns `404`.
MCPツール therealreal_designer
/therealreal/listingReturns 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.
レスポンスに関する注記
- A `url` that isn't a `therealreal.com` `/products/...` listing URL returns `400`. - An unrecognized listing URL returns `404`.
MCPツール therealreal_listing
/therealreal/designersReturns 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.
レスポンスに関する注記
- This is reference data that changes rarely, so responses are cached for 24 hours per `category` value — repeated calls within that window return the cached result rather than re-fetching from The RealReal. - An unrecognized `category` returns `400`.
MCPツール therealreal_designers
/therealreal/categoriesReturns 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.
レスポンスに関する注記
- This is reference data that changes rarely, so responses are cached for 24 hours — repeated calls within that window return the cached result rather than re-fetching from The RealReal. - The taxonomy covers every top-level department The RealReal sells across (`women`, `men`, `jewelry`, `watches`, `art`, `home`, `kids`, `beauty`), nested arbitrarily deep — not just the department a particular fetch happens to be scoped to.
MCPツール therealreal_categories
/therealreal/conditionsReturns 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.
レスポンスに関する注記
- This is reference data that changes rarely, so responses are cached for 24 hours — repeated calls within that window return the cached result rather than re-fetching from The RealReal. - The condition grades are, from best to worst: `Pristine`, `Excellent`, `Very Good`, `Good`, `Fair`, `As Is`.
MCPツール therealreal_conditions
/therealreal/autocompleteReturns The RealReal's own search-box typeahead suggestions for a partial query.
レスポンスに関する注記
- A missing `term` returns `400` before any upstream request is made. - A `term` with no suggestions returns `200` with `"suggestions": []`.
MCPツール therealreal_autocomplete
/therealreal/collectionReturns 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.
レスポンスに関する注記
- Response shape matches [search](therealreal-search.md): `total`, `has_more`, `next_after`, `listings`. - An unrecognized `slug` returns `404`.
MCPツール therealreal_collection
/therealreal/collectionsReturns 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.
レスポンスに関する注記
- This is reference data that changes rarely, so responses are cached for 24 hours — repeated calls within that window return the cached result rather than re-fetching from The RealReal. - The full set is discovered from The RealReal's own sitemap rather than scraped from on-site navigation links, which only surface a small fraction of the published collections.
MCPツール therealreal_collections
/therealreal/similarReturns 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).
レスポンスに関する注記
- Unlike search/category/designer, this is not paginated — The RealReal's own visual-similarity carousel returns a single fixed-size list, not a cursor-paged connection. - `product_id` must be numeric; a non-numeric value returns `400` before any upstream request is made.
MCPツール therealreal_similar
関連API
Marketplaces & Retail
Research new, used, and vintage instruments across Reverb listings, seller shops, and the Price Guide. Keep current asking prices separate from historical sales, and preserve model, finish, year, condition, and currency when comparing gear.
Marketplaces & Retail
Collect marketplace product signals from Amazon without building brittle storefront scrapers.
Marketplaces & Retail
Build resale, pricing, and marketplace workflows from structured eBay data.
The RealRealのスクレイピング方法
Crawlora's seven The RealReal endpoints return search, category/designer browse, listing, designer, category, and condition data as normalized JSON with one API key — categories, designers, and conditions are 24-hour-cached reference data, since they change far less often than listings.
Call /therealreal/categories for the full nested department/category/subcategory tree, /therealreal/designers (with an optional category department, defaulting to women, since each department carries a materially different list) for the designer directory, and /therealreal/conditions for the fixed 6-tier scale (Pristine through As Is) — all three cached 24 hours and feeding directly into search's own filters.
Send query (required — The RealReal only applies filters and pagination alongside a keyword; without one the underlying page serves an unrelated promotional collection instead) plus optional category_id, designer_id, condition_id, price_from, and price_to to /therealreal/search. next_after is an opaque cursor — pass it back as after with the same query and filters for the next page, until has_more is false.
Pass a category permalink (e.g. women/handbags) to /therealreal/category, or a designer slug (e.g. gucci) to /therealreal/designer, both from their respective discovery endpoints — same has_more/next_after/listings response shape as search, but without needing a keyword.
Pass a listing's full product url (from any search/category/designer result's own url field) to /therealreal/listing for its description, condition_detail notes, measurements, and category context — The RealReal's listing URLs are opaque slugs with no separate numeric-id lookup, so the full URL is the only reliable key.
On 2026-10-30 women/handbags reported total 275,843 and returned 120 listings with a next_after cursor, categories returned 7, and autocomplete answered 503 because the upstream blocked the request.
エージェントスキル
Crawlora のエージェントスキルをインストールすると、スクレイパーを書かずに、ドキュメント化された API 経由で The RealReal のデータを JSON として取得できます。The RealReal に対応するスキル:
Research luxury-fashion and watch resale listings, sold evidence, condition, and seller signals across specialist marketplaces. Use for sourcing or…
npx skills add github.com/Crawlora-org/crawlora-skills --skill luxury-resale-researchFAQ
Because The RealReal's own underlying search page only applies category/designer/condition/price filters and honors pagination when a keyword query is also present — without one, the page serves an unrelated promotional collection instead of a filtered result set. Use /therealreal/category or /therealreal/designer instead for keyword-free browsing.
Pass a designer slug from /therealreal/designers (e.g. gucci) to /therealreal/designer for a paginated listing feed for that designer, in the same has_more/next_after/listings shape as search — no keyword needed.
/therealreal/conditions returns the fixed 6-tier scale from best to worst: Pristine, Excellent, Very Good, Good, Fair, and As Is, each with an id usable as search's condition_id and a live matching-item count.
Over 5,000 in the women department alone (5,413 as of the last verified count) — /therealreal/designers takes a category department (women, men, fine-jewelry, watches, art, home, or kids, defaulting to women) since each carries a materially different designer list.
No — only your Crawlora API key. Search, category, designer, listing, and condition data are collected from The RealReal's public, credential-free, server-rendered pages.