Luxury jewelry pricing and availability monitoring
Use Tiffany & Co. endpoints to turn luxury jewelry pricing and availability monitoring into repeatable API requests with documented inputs and JSON responses.
Turn Tiffany & Co.'s own product catalogue into structured luxury jewelry data — every navigable category and curated shop id with live product counts, keyword search and per-category browsing with four sort orders, full product detail with every colour/style variation and live stock, and search-box autocomplete with result-count and popularity ranking. Normalized JSON, credential-free, USD pricing.
Browse Tiffany & Co.'s category taxonomy, search or browse the catalogue, get full product detail with variations, and get search suggestions as JSON.
Endpoint families
6
Documented params
37
Examples
8
Live catalog snapshot
Active endpoints
8
Methods
GET
Required params
15
Schema refs
8
{
"platform": "Tiffany & Co.",
"endpoint": "tiffany-search",
"method": "GET",
"path": "/tiffany/search",
"auth": "apiKey"
}Use cases
Browse Tiffany & Co.'s category taxonomy, search or browse the catalogue, get full product detail with variations, and get search suggestions as JSON.
Use Tiffany & Co. endpoints to turn luxury jewelry pricing and availability monitoring into repeatable API requests with documented inputs and JSON responses.
Use Tiffany & Co. endpoints to turn category and curated-shop coverage research into repeatable API requests with documented inputs and JSON responses.
Use Tiffany & Co. endpoints to turn search-demand and variation-assortment tracking into repeatable API requests with documented inputs and JSON responses.
Managed execution
Every figure below is read from the live Tiffany & Co. endpoint catalog — 8 endpoints, 37 documented request parameters, and 8 published response schemas — the same catalog Docs and Playground run against.
8 documented Tiffany & Co. endpoints, grouped into 8 request families — Categories, Category and Content Search, plus 5 more.
37 request parameters are documented across those Tiffany & Co. endpoints, 15 of them required — the full input contract is public before you write any integration code.
8 of the 8 Tiffany & Co. endpoints ship a recorded example response, and 8 carry a documented response schema — you can code against the real JSON before the first request.
Tiffany & Co. endpoints document their error responses (400, 404, 429 and 503) alongside the success schema, so a block, a rate limit, or a missing record comes back as a typed error rather than silently empty data.
8 hosted MCP tools back the Tiffany & Co. endpoints, so an agent can call the same routes with the same parameters and the same JSON contract, with no custom glue.
Coverage map
These cards are generated from the active endpoint catalog, so the landing page reflects the same API surface used by Docs and Playground.
/tiffany/categories
/tiffany/category
/tiffany/content-search
/tiffany/filters
/tiffany/product
/tiffany/search
Endpoint catalog
/tiffany/searchSearches Tiffany & Co.'s product catalog by free-text keyword. Returns normalized 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).
Response notes
- A genuine non-matching keyword, or a filter combination with no matches, returns a well-formed empty result (zero `total_products`), not an error. - `total_products` and `total_pages` reflect the catalog's own live count for the current `keyword`/`sort` combination. - Each product's `id` is the value to pass as `product_id` to `tiffany-product`. - `price` is USD. Example response: ```json {"code":200,"msg":"OK","data":{"keyword":"necklace","sort":"recommended","page":1,"per_page":24,"total_pages":25,"total_products":578,"count":1,"fetched_at":"2026-09-10T12:00:00Z","products":[{"id":"60014128","style_id":"1154463802","name":"Return to Tiffany®:Pink Double Heart Tag Pendant in Silver, Mini","product_type":"Pendant w/Chain","collection":"Return to Tiffany","material":"Sterling Silver","color":"Pink","price":325,"currency":"USD","in_stock":true,"image_url":"https://media.tiffany.com/is/image/tco/60014128_PDT_MAIN1X1","url":"https://www.tiffany.com/jewelry/necklaces-pendants/return-to-tiffany-sterling-silver-necklaces-pendants-60014128.html"}]}} ```
MCP tool tiffany_search
/tiffany/suggestReturns 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.
Response notes
- `result_count` is the number of catalog items the suggested phrase would return if searched. - `popularity` reflects the suggestion's own relative popularity ranking; higher is more popular. Example response: ```json {"code":200,"msg":"OK","data":{"query":"ring","count":1,"fetched_at":"2026-09-10T12:00:00Z","suggestions":[{"query":"rings","result_count":149866,"popularity":24446}]}} ```
MCP tool tiffany_suggest
/tiffany/categoriesLists 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".
Response notes
- `kind` distinguishes a real navigable department/subcategory (`category`) from a curated gift or merchandising shelf (`curated_shop`) -- both are valid, filterable category ids on the catalog, but they serve different browsing purposes. - `label` is a human-readable label derived from `id`; it is not a precise department/subcategory split. - `product_count` is the live count of catalog items carrying that category id as of `fetched_at`. Example response: ```json {"code":200,"msg":"OK","data":{"count":279,"fetched_at":"2026-09-10T12:00:00Z","categories":[{"id":"ecommerce_us_jewelry","label":"Jewelry","kind":"category","product_count":1561},{"id":"ecommerce_us_jewelry_necklaces_and_pendants","label":"Jewelry Necklaces And Pendants","kind":"category","product_count":536},{"id":"curated_ecommerce_us_gifts_anniversary_gifts","label":"Gifts Anniversary Gifts","kind":"curated_shop","product_count":229}]}} ```
MCP tool tiffany_categories
/tiffany/categoryReturns 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.
Response notes
- A hub-level category id, one with no current matching items, or a filter combination with no matches, returns a well-formed empty result (zero `total_products`), not an error. - `total_products` and `total_pages` reflect the catalog's own live count for the current `category`/`sort` combination. - Each product's `id` is the value to pass as `product_id` to `tiffany-product`. - `price` is USD. Example response: ```json {"code":200,"msg":"OK","data":{"category":"ecommerce_us_jewelry_necklaces_and_pendants","sort":"recommended","page":1,"per_page":24,"total_pages":23,"total_products":536,"count":1,"fetched_at":"2026-09-10T12:00:00Z","products":[{"id":"60014128","style_id":"1154463802","name":"Return to Tiffany®:Pink Double Heart Tag Pendant in Silver, Mini","product_type":"Pendant w/Chain","collection":"Return to Tiffany","material":"Sterling Silver","color":"Pink","price":325,"currency":"USD","in_stock":true,"image_url":"https://media.tiffany.com/is/image/tco/60014128_PDT_MAIN1X1","url":"https://www.tiffany.com/jewelry/necklaces-pendants/return-to-tiffany-sterling-silver-necklaces-pendants-60014128.html"}]}} ```
MCP tool tiffany_category
/tiffany/productReturns 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.
Response notes
- `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). - An unrecognized `product_id` returns a 404, not an empty result. Example response: ```json {"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"}} ```
MCP tool tiffany_product
/tiffany/content-searchSearches 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).
Response notes
- A genuine non-matching keyword returns a well-formed empty result (zero `total_results`), not an error. - `total_results` and `total_pages` reflect the live count for the current `keyword`. Example response: ```json {"code":200,"msg":"OK","data":{"keyword":"engagement ring guide","page":1,"per_page":10,"total_pages":1,"total_results":1,"count":1,"fetched_at":"2026-09-10T12:00:00Z","results":[{"title":"How to Choose a Wedding Band for Your Engagement Ring | Tiffany & Co. US","url":"https://www.tiffany.com/world-of-tiffany/style-guides/how-to-choose-wedding-band-for-your-engagement-ring.html","description":"Find the perfect wedding band to match your engagement ring at Tiffany & Co.","image_url":"https://media.tiffany.com/is/image/tco/2025_LE_WeddingBand_7x5_1"}]}} ```
MCP tool tiffany_content_search
/tiffany/filtersLists 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".
Response notes
- 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. Example response: ```json {"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}]}} ```
MCP tool tiffany_filters
/tiffany/storesFinds 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.
Response notes
- Results are ordered by distance from the given coordinate, nearest first. - `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. - A search with no stores within `radius` returns a well-formed empty result rather than an error. Example response: ```json {"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"}]}} ```
MCP tool tiffany_stores
Related APIs
Marketplaces & Retail
Collect marketplace product signals from Amazon without building brittle storefront scrapers.
Marketplaces & Retail
Build resale, pricing, and marketplace workflows from structured eBay data.
Marketplaces & Retail
Turn public Shop.app product and merchant pages into structured JSON for e-commerce product intelligence, price research, shop monitoring, and marketplace discovery workflows.
How to scrape Tiffany & Co.
Crawlora's five Tiffany & Co. endpoints return category, search, product, and suggestion data as normalized JSON with one API key — categories is the discovery endpoint for every id the catalogue accepts, so a caller never has to guess one from a storefront URL.
Call /tiffany/categories for every category id, each flagged kind: category (a real navigable department/subcategory) or curated_shop (a merchandising shelf like a gift guide) — both are valid, filterable ids. Pass one to /tiffany/category, or a keyword to /tiffany/search's keyword — both accept sort (recommended, price_asc, price_desc, or newest), page (1-500), and per_page (1-100, default 24).
total_products and total_pages on both endpoints reflect the catalogue's own live count for the current category or keyword and sort combination — a hub-level category id or a non-matching keyword returns a well-formed empty result (zero total_products) rather than an error.
Pass a product's id from a category or search result to /tiffany/product for description, material, price, live in_stock/low_inventory/available_quantity, and categories. variations lists every other purchasable colour/style of the same item, each with its own id and whether it is currently online.
Send query to /tiffany/suggest for the storefront's own typeahead — suggested phrases, each with a live result_count on the catalogue and a popularity score for relative ranking (higher is more popular).
FAQ
Call /tiffany/categories for every category id the catalogue accepts, each labelled kind: category for a real department/subcategory or curated_shop for a merchandising shelf like a gift guide. Pass any id to /tiffany/category for that listing's products.
Yes — total_products and total_pages reflect the catalogue's own live count for the current keyword and sort combination, not just the current page's size. A non-matching keyword returns a well-formed empty result with zero total_products rather than an error.
/tiffany/product's variations field lists every other purchasable colour or style of the same item, each with its own id (a separate product_id value) and an online flag for whether it is currently purchasable. Fetch each id through /tiffany/product for that variation's own detail.
/tiffany/product returns a 404, not an empty result — unlike some other catalogues in this family that return a well-formed empty response for an unrecognized id.
No — only your Crawlora API key. Tiffany & Co.'s category, search, product, and suggestion data are collected from its public, credential-free product catalogue.