GET/tiffany/categoriesapiKey1 credit/request
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".
Takes no parameters.
Sampled 14 Oct 2026: 279 items. Filled in every item: id, label, kind, product_count. In the sample: kind: category (237), curated_shop (42); product_count: 1 to 1,598, median 37; label: “Gifts” and 278 other values.
Open in Playground
GET/tiffany/categoryapiKey2 credits/request
Returns one page of a Tiffany & Co. category/browse listing. category is a category id from tiffany-categories's own id field (e.g. ecommerce_us_jewelry_necklaces_and_pendants). sort selects recommended (default), price_asc, price_desc, or newest. material, gemstone, color, product_type, gender, and designer are optional single-value filters -- see tiffany-filters for the live covered value space for each. A hub-level or emptied-out category id, or a filter combination with no matches, returns a well-formed empty result rather than an error.
Required: category. Optional: sort (4 allowed values: recommended, price_asc, price_desc, newest), page, per_page, material, gemstone, color, product_type, gender, designer.
Sampled 14 Oct 2026: 40 items. Filled in every item: id, style_id, name, product_type, material, price, currency, in_stock and 2 more. Not in every item: collection (35), color (29), designer (9), gemstone (7). In the sample: product_type: Pendant w/Chain (35), Necklace (5); price: 150 to 24,900, median 700; name: “Return to Tiffany®:Tiffany Blue® Double Heart Tag Pendant i…” and 38 other values; image_url: media.tiffany.com; in_stock: true in 39 of 40; collection: “Return to Tiffany” and 10 other values; material: Sterling Silver (23), 18k Yellow Gold (16), Platinum (1); color: Yellow Gold (15), Sterling Silver (4), No color (4) and 4 more.
Open in Playground
GET/tiffany/content-searchapiKey2 credits/request
Searches Tiffany & Co.'s own editorial pages -- style guides, gift guides, and other "World of Tiffany" articles -- by free-text keyword. Not product data: no price, stock, or item id fields. A genuine non-matching keyword returns a well-formed empty result (zero total_results).
Required: keyword. Optional: page, per_page.
Sampled 14 Oct 2026: 4 items. Filled in every item: title, url, description, image_url. In the sample: title: “How to Choose an Engagement Ring | Tiffany & Co. US” and 3 other values; url: tiffany.com; description: median 153 characters; image_url: “https://media.tiffany.com/is/image/tco/2025_ENGAGEMENTRING_…” and 3 other values.
Open in Playground
GET/tiffany/filtersapiKey1 credit/request
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".
Takes no parameters.
Sampled 14 Oct 2026: 63 items. Filled in every item: value, product_count. In the sample: product_count: 1 to 409, median 4; value: “.” and 62 other values.
Open in Playground
GET/tiffany/productapiKey2 credits/request
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.
Required: product_id.
Sampled 14 Oct 2026: 1 item. Filled in every item: id, color, online. In the sample: color: “Yellow Gold”; online: true in 1 of 1.
Open in Playground
GET/tiffany/searchapiKey2 credits/request
Searches Tiffany & Co.'s product catalog by free-text keyword. Returns product summaries with USD pricing, live stock status, material, gemstone, collection, and designer. sort selects recommended (default), price_asc, price_desc, or newest. material, gemstone, color, product_type, gender, and designer are optional single-value filters -- see tiffany-filters for the live covered value space for each. A genuine non-matching keyword, or a filter combination with no matches, returns a well-formed empty result (zero total_products).
Required: keyword. Optional: sort (4 allowed values: recommended, price_asc, price_desc, newest), page, per_page, material, gemstone, color, product_type, gender, designer.
Sampled 14 Oct 2026: 40 items. Filled in every item: id, style_id, name, product_type, material, price, currency, in_stock and 2 more. Not in every item: collection (37), color (29), designer (4), gemstone (12), low_inventory (1). In the sample: product_type: Necklace (22), Pendant w/Chain (18); price: 150 to 89,000, median 1,250; name: “Return to Tiffany®:Pink Double Heart Tag Pendant in Silver,…” and 36 other values; image_url: media.tiffany.com; in_stock: true in 39 of 40; collection: “Return to Tiffany” and 11 other values; material: Sterling Silver (24), 18k Yellow Gold (12), 18k White Gold (2) and 2 more; color: Yellow Gold (11), No color (8), Tiffany Blue® (4) and 5 more.
Open in Playground
GET/tiffany/storesapiKey1 credit/request
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.
Required: latitude, longitude. Optional: radius, limit.
Sampled 14 Oct 2026: 14 items. Filled in every item: store_id, name, address1, city, region, postal_code, country_code, phone and 8 more. Not in every item: internal_store_id (12), specialities (13), faqs (4), reservation_url (13), store_type (1). In the sample: name: Tiffany & Co. (11), Tiffany & Co. - Rockefeller Cen… (1), The Blue Box Cafe – 5th Ave (1) and 1 more; distance_miles: 0.48 to 44.81, median 13.43; address1: “37 Wall Street” and 13 other values; reservation_url: tiffany.com; closed: true in 0 of 14; specialities: median 2 entries; city: “New York” and 9 other values; region: NY (7), NJ (5), CT (2).
Open in Playground
GET/tiffany/suggestapiKey1 credit/request
Returns Tiffany & Co.'s own search-box suggestions (typeahead) for a partial query -- a flat list of suggested search phrases, each with its own live total result count on the product catalog. Not product data.
Required: query.
Sampled 14 Oct 2026: 10 items. Filled in every item: query, result_count, popularity. In the sample: result_count: 184 to 152,445, median 11,301; query: “rıng” and 9 other values; popularity: 4 to 22,181, median 30.
Open in Playground