Docs menu

Tiffany & Co. API endpoint

Tiffany & Co. Filter Values API

Lists every value tiffany-search's and tiffany-category's material, gemstone, color, product_type, gender, and designer filter parameters accept, each with a live product count -- resolves the discovery gap those parameters would otherwise leave as "find one on the live site's own filter sidebar".

GETapiKey1 credit/requestTiffany & Co.tiffany.filtersResponseDoc/tiffany/filters

Endpoint facts

Method: GET
API path: /tiffany/filters
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: Tiffany & Co.
Response schema: #/definitions/tiffany.filtersResponseDoc

Tiffany & Co. Scraper API Try Tiffany & Co. Filter Values API in Playground Tiffany & Co. API documentation

How this endpoint behaves

Lists every value tiffany-search's and tiffany-category's material, gemstone, color, product_type, gender, and designer filter parameters accept, each with a live product count. This is the discovery endpoint for those six filter fields, the same role tiffany-categories plays for the category parameter.

No parameters.

Notable response behavior:

Each top-level field (material, gemstone, color, product_type, gender, designer) lists the values accepted by the matching query parameter of the same name on tiffany-search and tiffany-category.
product_count is the live count of catalog items carrying that value as of fetched_at.
These value spaces are large (dozens to over a hundred entries per field) and shift as Tiffany's own merchandising changes, so they are documented here by discovery rather than enumerated in tiffany-search/tiffany-category's own docs.

Live monitoring

Monitored request: GET /tiffany/filters
Checks passed, 7 days to 14 Oct 2026: 99.8%
Median response time: 1.10 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /tiffany/filters
Items in color: 63
Fields filled in every checked item: 2

Field	Filled in, of 63 checked	Values in the sample
value	63	“.” and 62 other values
product_count	63	1 to 409, median 4

Request parameters

Parameter	Type	Required	Default	Description	Example
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/tiffany/filters" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "fetched_at": "2026-09-10T12:00:00Z",
    "material": [
      {
        "value": "18k Yellow Gold",
        "product_count": 466
      },
      {
        "value": "Platinum",
        "product_count": 234
      },
      {
        "value": "Sterling Silver",
        "product_count": 519
      }
    ],
    "gemstone": [
      {
        "value": "Diamond",
        "product_count": 92
      },
      {
        "value": "Round Brilliant Diamonds",
        "product_count": 644
      }
    ],
    "color": [
      {
        "value": "Rose Gold",
        "product_count": 314
      },
      {
        "value": "Yellow Gold",
        "product_count": 393
      }
    ],
    "product_type": [
      {
        "value": "Bracelet",
        "product_count": 219
      },
      {
        "value": "Ring",
        "product_count": 334
      }
    ],
    "gender": [
      {
        "value": "MENS",
        "product_count": 12
      },
      {
        "value": "UNISEX",
        "product_count": 537
      },
      {
        "value": "WOMENS",
        "product_count": 461
      }
    ],
    "designer": [
      {
        "value": "Elsa Peretti®",
        "product_count": 727
      },
      {
        "value": "Paloma Picasso®",
        "product_count": 65
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/tiffany.filtersResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	tiffany.FiltersResponse	No
data.color	array	No
data.color[].product_count	integer	No
data.color[].value	string	No
data.designer	array	No
data.designer[].product_count	integer	No
data.designer[].value	string	No
data.fetched_at	string	No
data.gemstone	array	No
data.gemstone[].product_count	integer	No
data.gemstone[].value	string	No
data.gender	array	No
data.gender[].product_count	integer	No
data.gender[].value	string	No
data.material	array	No
data.material[].product_count	integer	No
data.material[].value	string	No
data.product_type	array	No
data.product_type[].product_count	integer	No
data.product_type[].value	string	No
data.source_url	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/tiffany/filters" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Tiffany & Co. endpoint docs Tiffany & Co. Scraper API List Tiffany & Co. categories API documentation Browse a Tiffany & Co. category API documentation Tiffany & Co. Content Search API documentation Get a Tiffany & Co. product API documentation Search Tiffany & Co. products API documentation Find Tiffany & Co. store locations API documentation

Open in Playground Back to group

Docs menu

Tiffany & Co. API endpoint

Tiffany & Co. Filter Values API

GETapiKey1 credit/requestTiffany & Co.tiffany.filtersResponseDoc/tiffany/filters

Endpoint facts

Method: GET
API path: /tiffany/filters
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: Tiffany & Co.
Response schema: #/definitions/tiffany.filtersResponseDoc

Tiffany & Co. Scraper API Try Tiffany & Co. Filter Values API in Playground Tiffany & Co. API documentation

How this endpoint behaves

No parameters.

Notable response behavior:

Each top-level field (material, gemstone, color, product_type, gender, designer) lists the values accepted by the matching query parameter of the same name on tiffany-search and tiffany-category.
product_count is the live count of catalog items carrying that value as of fetched_at.
These value spaces are large (dozens to over a hundred entries per field) and shift as Tiffany's own merchandising changes, so they are documented here by discovery rather than enumerated in tiffany-search/tiffany-category's own docs.

Live monitoring

Monitored request: GET /tiffany/filters
Checks passed, 7 days to 14 Oct 2026: 99.8%
Median response time: 1.10 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /tiffany/filters
Items in color: 63
Fields filled in every checked item: 2

Field	Filled in, of 63 checked	Values in the sample
value	63	“.” and 62 other values
product_count	63	1 to 409, median 4

Request parameters

Parameter	Type	Required	Default	Description	Example
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/tiffany/filters" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "fetched_at": "2026-09-10T12:00:00Z",
    "material": [
      {
        "value": "18k Yellow Gold",
        "product_count": 466
      },
      {
        "value": "Platinum",
        "product_count": 234
      },
      {
        "value": "Sterling Silver",
        "product_count": 519
      }
    ],
    "gemstone": [
      {
        "value": "Diamond",
        "product_count": 92
      },
      {
        "value": "Round Brilliant Diamonds",
        "product_count": 644
      }
    ],
    "color": [
      {
        "value": "Rose Gold",
        "product_count": 314
      },
      {
        "value": "Yellow Gold",
        "product_count": 393
      }
    ],
    "product_type": [
      {
        "value": "Bracelet",
        "product_count": 219
      },
      {
        "value": "Ring",
        "product_count": 334
      }
    ],
    "gender": [
      {
        "value": "MENS",
        "product_count": 12
      },
      {
        "value": "UNISEX",
        "product_count": 537
      },
      {
        "value": "WOMENS",
        "product_count": 461
      }
    ],
    "designer": [
      {
        "value": "Elsa Peretti®",
        "product_count": 727
      },
      {
        "value": "Paloma Picasso®",
        "product_count": 65
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/tiffany.filtersResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	tiffany.FiltersResponse	No
data.color	array	No
data.color[].product_count	integer	No
data.color[].value	string	No
data.designer	array	No
data.designer[].product_count	integer	No
data.designer[].value	string	No
data.fetched_at	string	No
data.gemstone	array	No
data.gemstone[].product_count	integer	No
data.gemstone[].value	string	No
data.gender	array	No
data.gender[].product_count	integer	No
data.gender[].value	string	No
data.material	array	No
data.material[].product_count	integer	No
data.material[].value	string	No
data.product_type	array	No
data.product_type[].product_count	integer	No
data.product_type[].value	string	No
data.source_url	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/tiffany/filters" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Tiffany & Co. Filter Values API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Tiffany & Co. Filter Values API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related