Luxury jewelry pricing and availability monitoring
Tiffany & Co.エンドポイントを使えば、「Luxury jewelry pricing and availability monitoring」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
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.
エンドポイントファミリー
6
ドキュメント化されたパラメータ
37
サンプル数
8
ライブカタログスナップショット
稼働エンドポイント
8
メソッド
GET
必須パラメータ
15
スキーマ参照
8
{
"platform": "Tiffany & Co.",
"endpoint": "tiffany-search",
"method": "GET",
"path": "/tiffany/search",
"auth": "apiKey"
}ユースケース
Browse Tiffany & Co.'s category taxonomy, search or browse the catalogue, get full product detail with variations, and get search suggestions as JSON.
Tiffany & Co.エンドポイントを使えば、「Luxury jewelry pricing and availability monitoring」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
Tiffany & Co.エンドポイントを使えば、「Category and curated-shop coverage research」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
Tiffany & Co.エンドポイントを使えば、「Search-demand and variation-assortment tracking」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
マネージド実行
以下の数値はすべて、稼働中のTiffany & Co.エンドポイントカタログから取得しています(エンドポイント8件、ドキュメント化されたリクエストパラメータ37個、公開レスポンススキーマ8件)。DocsとPlaygroundが参照しているカタログと同じものです。
Tiffany & Co.のエンドポイントは8件、8つのリクエストファミリーに分類されています(Categories、Category、Content Searchほか5件)。
これらのTiffany & Co.エンドポイントには37個のリクエストパラメータがドキュメント化されており、うち15個が必須です。統合コードを書く前に入力仕様をすべて確認できます。
8件のTiffany & Co.エンドポイントのうち8件が実際のサンプルレスポンスを、8件がドキュメント化されたレスポンススキーマを備えています。最初のリクエストの前に実データの形に合わせて実装できます。
Tiffany & Co.のエンドポイントは成功時のスキーマに加えてエラーレスポンス(400、404、429、503)もドキュメント化しています。ブロック、レート制限、レコード欠損は空データではなく型付きのエラーとして返ります。
Tiffany & Co.のエンドポイントは8個のホスト型MCPツールとして提供されており、エージェントは同じパラメータと同じJSON契約のまま、追加の実装なしに同じルートを呼び出せます。
カバレッジマップ
/tiffany/categories
/tiffany/category
/tiffany/content-search
/tiffany/filters
/tiffany/product
/tiffany/search
エンドポイントカタログ
/tiffany/searchSearches 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).
レスポンスに関する注記
- 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.
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.
レスポンスに関する注記
- `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.
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".
レスポンスに関する注記
- `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`.
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.
レスポンスに関する注記
- 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.
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.
レスポンスに関する注記
- `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.
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).
レスポンスに関する注記
- 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`.
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".
レスポンスに関する注記
- 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.
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.
レスポンスに関する注記
- 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.
MCPツール tiffany_stores
関連API
Marketplaces & Retail
Research new, used, and vintage instruments across Reverb listings, seller shops, and the Price Guide. Keep current asking prices separate from historical sales, and preserve model, finish, year, condition, and currency when comparing gear.
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.
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).
On 2026-10-30 /tiffany/categories returned 281 entries with kind and product_count, necklaces and pendants reported total_products 550 over 14 pages of 40, and content-search for engagement ring guide returned 4 results.
エージェントスキル
Crawlora のエージェントスキルをインストールすると、スクレイパーを書かずに、ドキュメント化された API 経由で Tiffany & Co. のデータを JSON として取得できます。Tiffany & Co. に対応するスキル:
Research luxury-fashion and watch resale listings, sold evidence, condition, and seller signals across specialist marketplaces. Use for sourcing or…
npx skills add github.com/Crawlora-org/crawlora-skills --skill luxury-resale-researchFAQ
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.