API Reference
Use Crawlora's 1stDibs API endpoints to extract supported public 1stDibs data as structured JSON. This documentation covers 4 active endpoints including List 1stDibs categories and filters, List 1stDibs designers, Get a 1stDibs product, Search 1stDibs listings. 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 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/1stdibs/search?q=coffee&price=all+price&on_sale=true&measurements=true&this_week=true&returnable=true&recognized_seller=true&top_seller=true&sort=recommended&page=1&per_page=60" \
-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.
/1stdibs/categoriesapiKey1 credit/requestReturns the live handbags category directory, sort keys, price presets, and filter values discovered from 1stDibs. Returned category slugs are valid for firstdibs-search.
Required params: None
/1stdibs/designersapiKey1 credit/requestReturns designer values discovered from the selected 1stDibs category page. Each slug is valid for firstdibs-search's designer filter.
Required params: None
/1stdibs/productapiKey2 credits/requestReturns public product detail, pricing, availability, brand, category, description, and images for a 1stDibs product URL.
Required params: url:query
/1stdibs/searchapiKey2 credits/requestSearches or browses 1stDibs handbags and purses with category, designer, price, sale, color, period, location, gender, origin, seller, and sort filters.
Required params: None
| Endpoint | API path | Method | Credits | Required params | Docs | Playground |
|---|---|---|---|---|---|---|
| List 1stDibs categories and filters | /1stdibs/categories | GET | 1 credit/request | None | View docs | Try endpoint |
| List 1stDibs designers | /1stdibs/designers | GET | 1 credit/request | None | View docs | Try endpoint |
| Get a 1stDibs product | /1stdibs/product | GET | 2 credits/request | url:query | View docs | Try endpoint |
| Search 1stDibs listings | /1stdibs/search | GET | 2 credits/request | None | View docs | Try endpoint |