Luxury jewelry pricing and availability monitoring
Mit Tiffany & Co.-Endpunkten verwandelst du luxury jewelry pricing and availability monitoring in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
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.
Endpunkt-Familien
6
Dokumentierte Parameter
37
Beispiele
8
Live-Katalog-Snapshot
Aktive Endpunkte
8
Methoden
GET
Pflichtparameter
15
Schema-Referenzen
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.
Mit Tiffany & Co.-Endpunkten verwandelst du luxury jewelry pricing and availability monitoring in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
Mit Tiffany & Co.-Endpunkten verwandelst du category and curated-shop coverage research in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
Mit Tiffany & Co.-Endpunkten verwandelst du search-demand and variation-assortment tracking in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
Managed Execution
Jede Zahl unten stammt direkt aus dem Live-Tiffany & Co.-Endpunktkatalog — 8 Endpunkte, 37 dokumentierte Request-Parameter und 8 veröffentlichte Response-Schemas — demselben Katalog, gegen den auch Docs und Playground laufen.
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.
Abdeckungskarte
Diese Karten werden aus dem aktiven Endpunktkatalog generiert, damit die Landingpage dieselbe API-Oberfläche widerspiegelt, die auch Docs und Playground nutzen.
/tiffany/categories
/tiffany/category
/tiffany/content-search
/tiffany/filters
/tiffany/product
/tiffany/search
Endpunktkatalog
/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).
Hinweise zur Response
- 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.
Hinweise zur Response
- `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".
Hinweise zur Response
- `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.
Hinweise zur Response
- 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.
Hinweise zur Response
- `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).
Hinweise zur Response
- 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".
Hinweise zur Response
- 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.
Hinweise zur Response
- 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
Verwandte 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.
So scrapst du 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.