---
title: "List Tiffany & Co. categories"
method: GET
path: "/tiffany/categories"
tags: ["Tiffany & Co."]
---

# List Tiffany & Co. categories

`GET /tiffany/categories`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/tiffany/categories`
- Auth: API key in header `x-api-key`

Lists every category id Tiffany & Co.'s own product catalog accepts, each with a human-readable label, a kind (category for a real navigable department/subcategory, curated_shop for a curated gift/merchandising shelf), and a live product count. Each id is exactly what tiffany-category's own category parameter accepts -- resolves the category-discovery gap that parameter would otherwise leave as "find one from a storefront URL".

## Headers

- `x-api-key` string, required

## Response `200`

OK

- TiffanyCategoriesResponseDoc
  - `code` integer
  - `data` TiffanyCategoriesResponse
    - `categories` TiffanyCategoryFacet[]
      - `id` string: ID is the exact value to pass as tiffany-category's own "category" query parameter.
      - `kind` string: Kind distinguishes a real navigable department/category ("category", ids starting "ecommerce_us_") from a curated merchandising/gift shelf ("curated_shop", ids starting "curated_ecommerce_us_") -- both are valid, filterable category ids, but they serve different purposes: see the categories endpoint documentation.
      - `label` string: Label is a human-readable label derived from ID.
      - `product_count` integer: ProductCount is the live count of in-index products carrying this category id, as of FetchedAt.
    - `count` integer
    - `fetched_at` string
    - `source_url` string
  - `msg` string

## Other responses

- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)