Tiffany & Co. API endpoint
Finds Tiffany & Co. physical stores, boutiques, and cafes near a coordinate, ordered by distance. Each result includes address, phone, opening hours, in-store services and specialities, and live open/closed status.
/tiffany/storesQuery parameters:
latitude (required) -- latitude, -90 to 90.longitude (required) -- longitude, -180 to 180.radius (optional) -- search radius in miles, 1 to 500, defaults to 50.limit (optional) -- maximum stores to return, 1 to 50, defaults to 10.Notable response behavior:
store_id is Tiffany & Co.'s own stable location identifier; internal_store_id is a separate internal store code also carried upstream.store_type reflects Tiffany & Co.'s own store classification (for example Flagship, Boutique).hours lists each open day with its own opening/closing interval(s); a day absent from hours means the location publishes no scheduled hours for that day.closed reflects whether the location is currently marked permanently closed upstream.faqs carries store-specific question/answer pairs Tiffany & Co. publishes for that location (appointment policy, services offered, and similar); a location without published FAQs omits this field.reservation_url is a booking link for that store's own appointment scheduling, when Tiffany & Co. publishes one.radius returns a well-formed empty result rather than an error.| Field | Filled in, of 14 checked | Values in the sample |
|---|---|---|
| store_id | 14 | |
| internal_store_id | 12 | |
| name | 14 | Tiffany & Co. (11), Tiffany & Co. - Rockefeller Cen… (1), The Blue Box Cafe – 5th Ave (1) and 1 more |
| address1 | 14 | “37 Wall Street” and 13 other values |
| city | 14 | “New York” and 9 other values |
| region | 14 | NY (7), NJ (5), CT (2) |
| postal_code | 14 | |
| country_code | 14 | |
| phone | 14 | |
| latitude | 14 | |
| longitude | 14 | |
| distance_miles | 14 | 0.48 to 44.81, median 13.43 |
| closed | 14 | true in 0 of 14 |
| timezone | 14 | America/New_York in all 14 |
| specialities | 13 | median 2 entries |
| services | 14 | median 7 entries |
| hours | 14 | median 7 entries |
| faqs | 4 | median 1 entry |
| reservation_url | 13 | tiffany.com |
| url | 14 | tiffany.com |
| store_type | 1 | “Flagship” |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| latitude | number | Yes | Latitude, -90 to 90 | 40.7128 | |
| longitude | number | Yes | Longitude, -180 to 180 | -74.006 | |
| radius | number | No | Search radius in miles Minimum: 1. Maximum: 500. | ||
| limit | integer | No | Maximum stores to return Minimum: 1. Maximum: 50. | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/tiffany/stores?latitude=40.7128&longitude=-74.006&limit=10" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"latitude": 40.7128,
"longitude": -74.006,
"radius": 50,
"count": 1,
"fetched_at": "2026-09-10T12:00:00Z",
"stores": [
{
"store_id": "1799593",
"internal_store_id": "682",
"name": "Tiffany & Co. - The Landmark",
"store_type": "Flagship",
"address1": "727 5th Avenue",
"city": "New York",
"region": "NY",
"postal_code": "10022",
"country_code": "US",
"phone": "+12127558000",
"latitude": 40.7626931,
"longitude": -73.9739144,
"distance_miles": 3.83,
"closed": false,
"timezone": "America/New_York",
"specialities": [
"Wedding registry",
"Gifts"
],
"services": [
"Watch Repair & Sales",
"Jewelry Cleaning & Repair"
],
"hours": [
{
"day": "monday",
"closed": false,
"intervals": [
{
"start": "10:00",
"end": "20:00"
}
]
}
],
"faqs": [
{
"question": "Do I need to book an appointment to visit The Landmark?",
"answer": "Appointments are not required for general visits."
}
],
"reservation_url": "https://customer.bookingbug.com/?client=tiffany&company=NY"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/tiffany.storesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | tiffany.StoresResponse | No | ||||
| data.count | integer | No | ||||
| data.fetched_at | string | No | ||||
| data.latitude | number | No | ||||
| data.longitude | number | No | ||||
| data.radius | number | No | ||||
| data.source_url | string | No | ||||
| data.stores | array | No | ||||
| data.stores[].address1 | string | No | ||||
| data.stores[].city | string | No | ||||
| data.stores[].closed | boolean | No | ||||
| data.stores[].country_code | string | No | ||||
| data.stores[].distance_miles | number | No | ||||
| data.stores[].faqs | array | No | ||||
| data.stores[].faqs[].answer | string | No | ||||
| data.stores[].faqs[].question | string | No | ||||
| data.stores[].hours | array | No | ||||
| data.stores[].hours[].closed | boolean | No | ||||
| data.stores[].hours[].day | string | No | ||||
| data.stores[].hours[].intervals | array | No | ||||
| data.stores[].hours[].intervals[].end | string | No | ||||
| data.stores[].hours[].intervals[].start | string | No | ||||
| data.stores[].internal_store_id | string | No | ||||
| data.stores[].latitude | number | No | ||||
| data.stores[].longitude | number | No | ||||
| data.stores[].name | string | No | ||||
| data.stores[].phone | string | No | ||||
| data.stores[].postal_code | string | No | ||||
| data.stores[].region | string | No | ||||
| data.stores[].reservation_url | string | No | ||||
| data.stores[].services | array | No | ||||
| data.stores[].specialities | array | No | ||||
| data.stores[].store_id | string | No | ||||
| data.stores[].store_type | string | No | Flagship | |||
| data.stores[].timezone | string | No | ||||
| data.stores[].url | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/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/stores?latitude=40.7128&longitude=-74.006&limit=10" \
-H "x-api-key: $CRAWLORA_API_KEY"