Luxury jewelry pricing and availability monitoring
Usa los endpoints de Tiffany & Co. para convertir luxury jewelry pricing and availability monitoring en solicitudes API repetibles con inputs documentados y respuestas JSON.
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.
Familias de endpoints
6
Parámetros documentados
37
Ejemplos
8
Snapshot en vivo del catálogo
Endpoints activos
8
Métodos
GET
Parámetros obligatorios
15
Referencias de esquema
8
{
"platform": "Tiffany & Co.",
"endpoint": "tiffany-search",
"method": "GET",
"path": "/tiffany/search",
"auth": "apiKey"
}Casos de uso
Browse Tiffany & Co.'s category taxonomy, search or browse the catalogue, get full product detail with variations, and get search suggestions as JSON.
Usa los endpoints de Tiffany & Co. para convertir luxury jewelry pricing and availability monitoring en solicitudes API repetibles con inputs documentados y respuestas JSON.
Usa los endpoints de Tiffany & Co. para convertir category and curated-shop coverage research en solicitudes API repetibles con inputs documentados y respuestas JSON.
Usa los endpoints de Tiffany & Co. para convertir search-demand and variation-assortment tracking en solicitudes API repetibles con inputs documentados y respuestas JSON.
Ejecución gestionada
Cada cifra de abajo se lee directamente del catálogo de endpoints en vivo de Tiffany & Co. — 8 endpoints, 37 parámetros de solicitud documentados y 8 esquemas de respuesta publicados — el mismo catálogo contra el que corren Docs y Playground.
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.
Mapa de cobertura
Estas tarjetas se generan a partir del catálogo de endpoints activo, así que la landing page refleja la misma superficie de API que usan Docs y Playground.
/tiffany/categories
/tiffany/category
/tiffany/content-search
/tiffany/filters
/tiffany/product
/tiffany/search
Catálogo de endpoints
/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).
Notas de la respuesta
- 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"}]}} ```
Herramienta MCP 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.
Notas de la respuesta
- `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}]}} ```
Herramienta MCP 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".
Notas de la respuesta
- `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}]}} ```
Herramienta MCP 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.
Notas de la respuesta
- 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"}]}} ```
Herramienta MCP 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.
Notas de la respuesta
- `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"}} ```
Herramienta MCP 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).
Notas de la respuesta
- 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"}]}} ```
Herramienta MCP 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".
Notas de la respuesta
- 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}]}} ```
Herramienta MCP 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.
Notas de la respuesta
- 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"}]}} ```
Herramienta MCP tiffany_stores
APIs relacionadas
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.
Cómo hacer scraping de 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).
Preguntas frecuentes
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.