1stDibs API endpoint
Returns the details of one 1stDibs product, identified by its product `url`: `name`, `brand`, `category`, `description`, `images`, `price` with `currency`, and the `in_stock` flag. The price is in USD and is present only when 1stDibs shows one.
/1stdibs/productReturns public product detail for a 1stDibs product url, including USD price when available, availability, brand, category, description, and images. Requires x-api-key.
| Field | In the sample | Value in the sample |
|---|---|---|
| id | Has a value | |
| url | Has a value | 1stdibs.com |
| name | Has a value | “Chanel Nano Kelly Bag NEW Lilac Gold Hardware” |
| brand | Has a value | “Chanel” |
| description | Has a value | 583 characters |
| images | Has a value | 13 entries |
| in_stock | Has a value | false |
| category | Has a value | “Structured Shoulder Bags” |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| url | string | Yes | 1stDibs product URL | https://www.1stdibs.com/jewelry/necklaces/chain-necklaces/vintage-gucci-necklace-double-g-gucci-logo-sterling-silver-pendant/id-j_29181182/ | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/1stdibs/product?url=https%3A%2F%2Fwww.1stdibs.com%2Fjewelry%2Fnecklaces%2Fchain-necklaces%2Fvintage-gucci-necklace-double-g-gucci-logo-sterling-silver-pendant%2Fid-j_29181182%2F" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"id": "https://www.1stdibs.com/fashion/handbags-purses-bags/id-v_22700192/",
"name": "Designer handbag",
"brand": "Chanel",
"price": 5857.66,
"currency": "USD",
"in_stock": true,
"images": [
"https://a.1stdibscdn.com/image.jpg"
]
}
}Request schema
No body schema
Response schema
#/definitions/firstdibs.productDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | firstdibs.Detail | No | ||||
| data.brand | string | No | ||||
| data.category | string | No | ||||
| data.currency | string | No | ||||
| data.description | string | No | ||||
| data.id | string | No | ||||
| data.images | array | No | ||||
| data.in_stock | boolean | No | ||||
| data.name | string | No | ||||
| data.price | number | No | ||||
| data.url | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/1stdibs/product?url=https%3A%2F%2Fwww.1stdibs.com%2Fjewelry%2Fnecklaces%2Fchain-necklaces%2Fvintage-gucci-necklace-double-g-gucci-logo-sterling-silver-pendant%2Fid-j_29181182%2F" \
-H "x-api-key: $CRAWLORA_API_KEY"