Tiffany & Co. API endpoint
Returns full product detail for one item: name, description, brand, collection, designer, material, gemstone, USD price, live stock status, category tree, every color/style variation, and images. product_id is Tiffany & Co.'s own item id, as returned by tiffany-search's or tiffany-category's own products[].id field.
/tiffany/productNotable response behavior:
price is USD; in_stock and low_inventory reflect live stock status; available_quantity is the live unit count.variations lists every other purchasable color/style of the same item, each with its own id (a separate product_id value) and whether it is currently online.categories lists the item's own top-level and immediate category ids (values also accepted by tiffany-category's category parameter).product_id returns a 404, not an empty result.| Field | Filled in, of 1 checked | Values in the sample |
|---|---|---|
| id | 1 | |
| color | 1 | “Yellow Gold” |
| online | 1 | true in 1 of 1 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| product_id | string | Yes | Item id, from a search or category result's id field | 60957398 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/tiffany/product?product_id=60957398" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"product_id": "60957398",
"style_id": "1414151568",
"name": "Elsa Peretti® Open Heart Pendant in Yellow Gold, 7 mm",
"description": "The simple, evocative shape of Elsa Peretti® Open Heart designs celebrates the spirit of love. This elegant style is one of her most celebrated icons.",
"collection": "Elsa Peretti",
"product_type": "Pendant w/Chain",
"material": "18k Yellow Gold",
"price": 950,
"currency": "USD",
"in_stock": true,
"available_quantity": 42,
"categories": [
"ecommerce_us_jewelry",
"ecommerce_us_jewelry_necklaces_and_pendants"
],
"images": [
"https://media.tiffany.com/is/image/tco/60957398_PDT_MAIN1X1"
],
"variations": [
{
"id": "60957398",
"color": "Yellow Gold",
"online": true
}
],
"url": "https://www.tiffany.com/jewelry/necklaces-pendants/ep-open-heart-18k-yellow-gold-necklaces-pendants-60957398.html",
"fetched_at": "2026-09-10T12:00:00Z"
}
}Request schema
No body schema
Response schema
#/definitions/tiffany.productResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | tiffany.ProductDetailResponse | No | ||||
| data.available_quantity | integer | No | ||||
| data.brand | string | No | ||||
| data.categories | array | No | ||||
| data.collection | string | No | ||||
| data.color | string | No | ||||
| data.currency | string | No | ||||
| data.description | string | No | ||||
| data.designer | string | No | ||||
| data.fetched_at | string | No | ||||
| data.gemstone | string | No | ||||
| data.images | array | No | ||||
| data.in_stock | boolean | No | ||||
| data.low_inventory | boolean | No | ||||
| data.material | string | No | ||||
| data.name | string | No | ||||
| data.price | number | No | ||||
| data.product_id | string | No | ||||
| data.product_type | string | No | ||||
| data.size | string | No | ||||
| data.source_url | string | No | ||||
| data.style_id | string | No | ||||
| data.url | string | No | ||||
| data.variations | array | No | ||||
| data.variations[].color | string | No | ||||
| data.variations[].id | string | No | ||||
| data.variations[].online | boolean | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/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/tiffany/product?product_id=60957398" \
-H "x-api-key: $CRAWLORA_API_KEY"