Pre-owned luxury handbag pricing research
Use 1stDibs endpoints to turn pre-owned luxury handbag pricing research into repeatable API requests with documented inputs and JSON responses.
Turn 1stDibs' public handbags and purses marketplace into structured JSON — keyword and filtered search across designer, color, period, location, and price, the category and designer directories that feed search's own filters, and full listing detail with USD price, availability, brand, and images. Normalized JSON, credential-free.
Search 1stDibs' public handbags catalog by designer and price, browse category and designer directories, and get full listing detail as structured JSON.
Endpoint families
4
Documented params
26
Examples
4
Live catalog snapshot
Active endpoints
4
Methods
GET
Required params
5
Schema refs
4
{
"platform": "1stDibs",
"endpoint": "firstdibs-search",
"method": "GET",
"path": "/1stdibs/search",
"auth": "apiKey"
}Use cases
Search 1stDibs' public handbags catalog by designer and price, browse category and designer directories, and get full listing detail as structured JSON.
Use 1stDibs endpoints to turn pre-owned luxury handbag pricing research into repeatable API requests with documented inputs and JSON responses.
Use 1stDibs endpoints to turn designer and category coverage tracking into repeatable API requests with documented inputs and JSON responses.
Use 1stDibs endpoints to turn new-listing and availability monitoring into repeatable API requests with documented inputs and JSON responses.
Managed execution
Every figure below is read from the live 1stDibs endpoint catalog — 4 endpoints, 26 documented request parameters, and 4 published response schemas — the same catalog Docs and Playground run against.
4 documented 1stDibs endpoints, grouped into 4 request families — Categories, Designers and Product, plus 1 more.
26 request parameters are documented across those 1stDibs endpoints, 5 of them required — the full input contract is public before you write any integration code.
4 of the 4 1stDibs endpoints ship a recorded example response, and 4 carry a documented response schema — you can code against the real JSON before the first request.
1stDibs endpoints document their error responses (400, 404 and 503) alongside the success schema, so a block, a rate limit, or a missing record comes back as a typed error rather than silently empty data.
4 hosted MCP tools back the 1stDibs endpoints, so an agent can call the same routes with the same parameters and the same JSON contract, with no custom glue.
Coverage map
These cards are generated from the active endpoint catalog, so the landing page reflects the same API surface used by Docs and Playground.
/1stdibs/categories
/1stdibs/designers
/1stdibs/product
/1stdibs/search
Endpoint catalog
/1stdibs/searchSearches or browses 1stDibs handbags and purses with category, designer, price, sale, color, period, location, gender, origin, seller, and sort filters.
MCP tool firstdibs_search
/1stdibs/productReturns public product detail, pricing, availability, brand, category, description, and images for a 1stDibs product URL.
MCP tool firstdibs_product
/1stdibs/categoriesReturns the live handbags category directory, sort keys, price presets, and filter values discovered from 1stDibs. Returned category slugs are valid for firstdibs-search.
MCP tool firstdibs_categories
/1stdibs/designersReturns designer values discovered from the selected 1stDibs category page. Each slug is valid for firstdibs-search's designer filter.
MCP tool firstdibs_designers
Related APIs
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.
Marketplaces & Retail
Turn public Shop.app product and merchant pages into structured JSON for e-commerce product intelligence, price research, shop monitoring, and marketplace discovery workflows.
How to scrape 1stDibs
Crawlora's four 1stDibs endpoints return category, designer, search, and product data as normalized JSON with one API key — every endpoint is currently scoped to 1stDibs' handbags and purses catalog, not its full multi-category antiques and furniture marketplace.
Call /1stdibs/categories for handbag category slugs (e.g. shoulder-bags), the accepted sort values (recommended, newest, price-high, price-low, popular), and the five price presets /1stdibs/search's price parameter accepts. Pass an optional category slug to /1stdibs/designers for the designer filter values discovered from that category page.
Send q plus any combination of category, designer, color, period, location, gender, origin, price (one of the five presets) or price_min/price_max, on_sale, measurements, this_week, returnable, and recognized_seller/top_seller to /1stdibs/search. per_page is 60 or 120, and sort takes the same five values as categories.
Pass a listing's own url (from any search result's url field) to /1stdibs/product for its USD price when available, brand, category, description, availability, and images.
FAQ
Just handbags and purses currently — all four endpoints (categories, designers, search, product) are scoped to that one category, not 1stDibs' wider antiques, furniture, jewelry, and art marketplace.
Call /1stdibs/designers with an optional category slug for the designer filter values 1stDibs itself shows for that category page, then pass one of their slug values (e.g. chanel) to /1stdibs/search's designer parameter.
One of five presets returned by /1stdibs/categories' price_presets field: "all price", "[* TO 999]", "[* TO 1999]", "[* TO 4999]", or "[5000 TO *]" — pass the exact string as price, or use price_min/price_max for an arbitrary custom range.
/1stdibs/product only returns a USD price field when 1stDibs itself publishes a numeric USD price for that listing — some listings show a non-numeric price state instead, in which case the field is omitted rather than set to zero.
No — only your Crawlora API key. 1stDibs' category, designer, search, and product data are collected from its public, credential-free handbags and purses catalog.