--- type: "firecrawl-provider" description: "Yahoo! Auctions (ヤフオク!) open and closed listing search with sold-price statistics, item detail with shipping fees and related items, seller profiles, category/brand/price facets and keyword suggestions, from the site's own JSON API." use_when: "Yahoo! Auctions (ヤフオク!) open and closed listing search with sold-price statistics, item detail with shipping fees and related items, seller profiles, category/brand/price facets and keyword suggestions, from the site's own JSON API." categories: "Retail" capabilities: 5 credits_per_call: 5 --- # Yahoo! Auctions Japan on Firecrawl Alexandria Yahoo! Auctions (ヤフオク!) open and closed listing search with sold-price statistics, item detail with shipping fees and related items, seller profiles, category/brand/price facets and keyword suggestions, from the site's own JSON API. - Categories: Retail - Category index: [Retail category](https://firecrawl.dev/alexandria/agents/categories/retail) - Provider key: `auctions-yahoo-co-jp` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://firecrawl.dev/app/alexandria/auctions-yahoo-co-jp) - [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/auctions-yahoo-co-jp/openapi.json) ## Capabilities - [Category facets](https://firecrawl.dev/alexandria/agents/providers/auctions-yahoo-co-jp/listings/category_facets): Category tree position (parent, current, children with counts), top brands and price-range buckets for a Yahoo! Auctions category, optionally narrowed by a keyword. category_id 0 is the root (top-level categories; child counts are not computed at the root). - [Item](https://firecrawl.dev/alexandria/agents/providers/auctions-yahoo-co-jp/listings/item): One Yahoo! Auctions listing by auction id or listing URL: title, status (open|closed), current/final price, buy-now price, bids, times, condition, description, images, category and brand paths, seller profile and rating, shipping methods and payment options. Optionally adds the shipping fee table for a destination prefecture and related listings. - [Search](https://firecrawl.dev/alexandria/agents/providers/auctions-yahoo-co-jp/listings/search): Search Yahoo! Auctions Japan listings by keyword, category and/or seller. status OPEN lists live auctions; status CLOSED lists ended auctions with their final price and adds avg/min/max sold-price statistics for the whole result set. Prices are JPY integers, times are JST (+09:00) ISO strings, text is Japanese. - [Seller](https://firecrawl.dev/alexandria/agents/providers/auctions-yahoo-co-jp/listings/seller): Public profile of a Yahoo! Auctions seller by aucUserId: display name, store/eKYC flags, rating total and positive ratio, profile message and the URL of the seller's listings. Use search with seller_id for the listings themselves. - [Suggest](https://firecrawl.dev/alexandria/agents/providers/auctions-yahoo-co-jp/listings/suggest): Keyword completions Yahoo! Auctions offers for a search prefix (Japanese or Latin text). ## 1. Choose this provider when Yahoo! Auctions (ヤフオク!) open and closed listing search with sold-price statistics, item detail with shipping fees and related items, seller profiles, category/brand/price facets and keyword suggestions, from the site's own JSON API. ## 2. Minimal request Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls. ```json { "provider": "auctions-yahoo-co-jp", "capability": "listings/category_facets", "options": { "category_id": 23684 } } ``` ## 3. Add provider options Use only the options needed for the task: - `category_id` (number): category_id Example: `0` - `query` (string): query Example: `` - `status` (string): status Example: `OPEN` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "auctions-yahoo-co-jp", capability: "listings/category_facets", options: { category_id: 23684, }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "auctions-yahoo-co-jp", "capability": "listings/category_facets", "options": { "category_id": 23684 } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "auctions-yahoo-co-jp", "capability": "listings/category_facets", "options": { "category_id": 23684 } } }' ``` ### CLI ```sh firecrawl scrape 'auctions-yahoo-co-jp/listings/category_facets' \ --options '{"category_id":23684}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "auctions-yahoo-co-jp", "capability": "listings/category_facets", "options": { "category_id": 23684 } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "auctions-yahoo-co-jp", "capability": "listings/category_facets", "options": { "category_id": 23684 } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "brands": [ { "count": 17080, "id": 101345, "kana_name": "ニコン", "name": "ニコン", "url": "https://auctions.yahoo.co.jp/brand/1345" }, { "count": 16996, "id": 100614, "kana_name": "キヤノン", "name": "キヤノン", "url": "https://auctions.yahoo.co.jp/brand/614" }, { "count": 8335, "id": 102135, "kana_name": "リコー", "name": "リコー", "url": "https://auctions.yahoo.co.jp/brand/2135" }, { "count": 4023, "id": 100537, "kana_name": "オリンパス", "name": "オリンパス", "url": "https://auctions.yahoo.co.jp/brand/537" }, { "count": 3526, "id": 100774, "kana_name": "コニカミノルタ", "name": "コニカミノルタ", "url": "https://auctions.yahoo.co.jp/brand/774" }, { "count": 2613, "id": 100880, "kana_name": "シグマ", "name": "シグマ", "url": "https://auctions.yahoo.co.jp/brand/880" }, { "count": 2371, "id": 100067, "kana_name": "タムロン", "name": "TAMRON", "url": "https://auctions.yahoo.co.jp/brand/67" }, { "count": 2143, "id": 101091, "kana_name": "ソニー", "name": "SONY", "url": "https://auctions.yahoo.co.jp/brand/1091" }, { "count": 1827, "id": 102073, "kana_name": "ライカ", "name": "ライカ", "url": "https://auctions.yahoo.co.jp/brand/2073" }, { "count": 1414, "id": 101460, "kana_name": "パナソニック", "name": "Panasonic", "url": "https://auctions.yahoo.co.jp/brand/1460" }, { "count": 1097, "id": 116440, "kana_name": "ツァイス", "name": "ZEISS", "url": "https://auctions.yahoo.co.jp/brand/16440" }, { "count": 1091, "id": 104459, "kana_name": "ケンコー・トキナー", "name": "ケンコー・トキナー", "url": "https://auctions.yahoo.co.jp/brand/4459" }, { "count": 994, "id": 102365, "kana_name": "フジフイルム", "name": "FUJIFILM", "url": "https://auctions.yahoo.co.jp/brand/2365" }, { "count": 521, "id": 101914, "kana_name": "マミヤ", "name": "Mamiya", "url": "https://auctions.yahoo.co.jp/brand/1914" }, { "count": 373, "id": 116853, "kana_name": "コシナ", "name": "コシナ", "url": "https://auctions.yahoo.co.jp/brand/16853" }, { "count": 347, "id": 152635, "kana_name": "メイショウコウガク", "name": "銘匠光学", "url": "https://auctions.yahoo.co.jp/brand/52635" }, { "count": 345, "id": 135365, "kana_name": "コンタックス", "name": "CONTAX", "url": "https://auctions.yahoo.co.jp/brand/35365" }, { "count": 334, "id": 116441, "kana_name": "ケーアンドエフ コンセプト", "name": "K&F CONCEPT", "url": "https://auctions.yahoo.co.jp/brand/16441" }, { "count": 304, "id": 116878, "kana_name": "ヂョンイー", "name": "中一光学", "url": "https://auctions.yahoo.co.jp/brand/16878" }, { "count": 259, "id": 136464, "kana_name": "シチコウショウ", "name": "七工匠", "url": "https://auctions.yahoo.co.jp/brand/36464" } ], "category_id": 23684, "children": [ { "count": 43157, "id": 2084261682, "is_leaf": false, "name": "一眼カメラ用（オートフォーカス）" }, { "count": 28667, "id": 2084261691, "is_leaf": false, "name": "一眼カメラ用（マニュアルフォーカス）" }, { "count": 2671, "id": 23692, "is_leaf": true, "name": "大判、中判カメラ用" }, { "count": 682, "id": 2084041624, "is_leaf": true, "name": "コンパクトカメラ用" }, { "count": 0, "id": 2084313032, "is_leaf": true, "name": "カタログ" }, { "count": 0, "id": 2084052265, "is_leaf": true, "name": "説明書" }, { "count": 6612, "id": 23716, "is_leaf": true, "name": "その他" } ], "country": "JP", "currency": "JPY", "current": { "count": 88060, "id": 23684, "is_leaf": false, "name": "レンズ" }, "observed_at_ms": 1791587845291, "parent": { "id": 23636, "name": "カメラ、光学機器" }, "price_ranges": [ { "count": 83297, "from": 0, "to": 113999 }, { "count": 3347, "from": 114000, "to": 227999 }, { "count": 775, "from": 228000, "to": 343999 }, { "count": 309, "from": 344000, "to": 510999 }, { "count": 196, "from": 511000, "to": 812999 }, { "count": 136, "from": 813000, "to": 8200999 } ], "query": null, "status": "OPEN" } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Category facets - Capability: `listings/category_facets` - Description: Category tree position (parent, current, children with counts), top brands and price-range buckets for a Yahoo! Auctions category, optionally narrowed by a keyword. category_id 0 is the root (top-level categories; child counts are not computed at the root). - Instructions: To discover category ids to pass to search, or to see brand and price distribution for a category or keyword. - Cost: 5 credits per call - Capability file: [Category facets](https://firecrawl.dev/alexandria/agents/providers/auctions-yahoo-co-jp/listings/category_facets) Accepted options: - `category_id` (number): category_id Example: `0` - `query` (string): query Example: `` - `status` (string): status Example: `OPEN` Response schema example: ```json { "brands": [ { "count": 17080, "id": 101345, "kana_name": "ニコン", "name": "ニコン", "url": "https://auctions.yahoo.co.jp/brand/1345" }, { "count": 16996, "id": 100614, "kana_name": "キヤノン", "name": "キヤノン", "url": "https://auctions.yahoo.co.jp/brand/614" }, { "count": 8335, "id": 102135, "kana_name": "リコー", "name": "リコー", "url": "https://auctions.yahoo.co.jp/brand/2135" }, { "count": 4023, "id": 100537, "kana_name": "オリンパス", "name": "オリンパス", "url": "https://auctions.yahoo.co.jp/brand/537" }, { "count": 3526, "id": 100774, "kana_name": "コニカミノルタ", "name": "コニカミノルタ", "url": "https://auctions.yahoo.co.jp/brand/774" }, { "count": 2613, "id": 100880, "kana_name": "シグマ", "name": "シグマ", "url": "https://auctions.yahoo.co.jp/brand/880" }, { "count": 2371, "id": 100067, "kana_name": "タムロン", "name": "TAMRON", "url": "https://auctions.yahoo.co.jp/brand/67" }, { "count": 2143, "id": 101091, "kana_name": "ソニー", "name": "SONY", "url": "https://auctions.yahoo.co.jp/brand/1091" }, { "count": 1827, "id": 102073, "kana_name": "ライカ", "name": "ライカ", "url": "https://auctions.yahoo.co.jp/brand/2073" }, { "count": 1414, "id": 101460, "kana_name": "パナソニック", "name": "Panasonic", "url": "https://auctions.yahoo.co.jp/brand/1460" }, { "count": 1097, "id": 116440, "kana_name": "ツァイス", "name": "ZEISS", "url": "https://auctions.yahoo.co.jp/brand/16440" }, { "count": 1091, "id": 104459, "kana_name": "ケンコー・トキナー", "name": "ケンコー・トキナー", "url": "https://auctions.yahoo.co.jp/brand/4459" }, { "count": 994, "id": 102365, "kana_name": "フジフイルム", "name": "FUJIFILM", "url": "https://auctions.yahoo.co.jp/brand/2365" }, { "count": 521, "id": 101914, "kana_name": "マミヤ", "name": "Mamiya", "url": "https://auctions.yahoo.co.jp/brand/1914" }, { "count": 373, "id": 116853, "kana_name": "コシナ", "name": "コシナ", "url": "https://auctions.yahoo.co.jp/brand/16853" }, { "count": 347, "id": 152635, "kana_name": "メイショウコウガク", "name": "銘匠光学", "url": "https://auctions.yahoo.co.jp/brand/52635" }, { "count": 345, "id": 135365, "kana_name": "コンタックス", "name": "CONTAX", "url": "https://auctions.yahoo.co.jp/brand/35365" }, { "count": 334, "id": 116441, "kana_name": "ケーアンドエフ コンセプト", "name": "K&F CONCEPT", "url": "https://auctions.yahoo.co.jp/brand/16441" }, { "count": 304, "id": 116878, "kana_name": "ヂョンイー", "name": "中一光学", "url": "https://auctions.yahoo.co.jp/brand/16878" }, { "count": 259, "id": 136464, "kana_name": "シチコウショウ", "name": "七工匠", "url": "https://auctions.yahoo.co.jp/brand/36464" } ], "category_id": 23684, "children": [ { "count": 43157, "id": 2084261682, "is_leaf": false, "name": "一眼カメラ用（オートフォーカス）" }, { "count": 28667, "id": 2084261691, "is_leaf": false, "name": "一眼カメラ用（マニュアルフォーカス）" }, { "count": 2671, "id": 23692, "is_leaf": true, "name": "大判、中判カメラ用" }, { "count": 682, "id": 2084041624, "is_leaf": true, "name": "コンパクトカメラ用" }, { "count": 0, "id": 2084313032, "is_leaf": true, "name": "カタログ" }, { "count": 0, "id": 2084052265, "is_leaf": true, "name": "説明書" }, { "count": 6612, "id": 23716, "is_leaf": true, "name": "その他" } ], "country": "JP", "currency": "JPY", "current": { "count": 88060, "id": 23684, "is_leaf": false, "name": "レンズ" }, "observed_at_ms": 1791587845291, "parent": { "id": 23636, "name": "カメラ、光学機器" }, "price_ranges": [ { "count": 83297, "from": 0, "to": 113999 }, { "count": 3347, "from": 114000, "to": 227999 }, { "count": 775, "from": 228000, "to": 343999 }, { "count": 309, "from": 344000, "to": 510999 }, { "count": 196, "from": 511000, "to": 812999 }, { "count": 136, "from": 813000, "to": 8200999 } ], "query": null, "status": "OPEN" } ``` ### Item - Capability: `listings/item` - Description: One Yahoo! Auctions listing by auction id or listing URL: title, status (open|closed), current/final price, buy-now price, bids, times, condition, description, images, category and brand paths, seller profile and rating, shipping methods and payment options. Optionally adds the shipping fee table for a destination prefecture and related listings. - Instructions: Full detail for an auction id from search or a pasted auctions.yahoo.co.jp / page.auctions.yahoo.co.jp listing URL. - Cost: 5 credits per call - Capability file: [Item](https://firecrawl.dev/alexandria/agents/providers/auctions-yahoo-co-jp/listings/item) Accepted options: - `auction_id` (string): Auction id, e.g. f1247784520. Pattern: ^[a-z]?[0-9]{6,12}$. Example: `` - `include_related` (boolean): Also fetch up to 10 related listings the site recommends for this item. Example: `false` - `shipping_prefecture_code` (number): JIS prefecture code (13 = Tokyo). When given, shipping_fees lists the methods and fees to that prefecture. Example: `10` - `url` (string): Listing URL on auctions.yahoo.co.jp or page.auctions.yahoo.co.jp (/jp/auction/{id}). Provide either auction_id or url. Example: `` Response schema example: ```json { "auction_id": "b1247722169", "bid_count": 1, "bidder_count": 1, "brand_path": [ { "id": 101345, "name": "ニコン" }, { "id": 117441, "name": "NIKKOR" } ], "buy_now_price": 24000, "category_path": [ { "id": 0, "name": "オークション" }, { "id": 23632, "name": "家電、AV、カメラ" }, { "id": 23636, "name": "カメラ、光学機器" }, { "id": 23684, "name": "レンズ" }, { "id": 2084261682, "name": "一眼カメラ用（オートフォーカス）" }, { "id": 2084261684, "name": "ニコン" } ], "charge_for_shipping": "winner", "condition": "目立った傷や汚れなし", "country": "JP", "currency": "JPY", "description_html": "ニコンFマウント用広角ズームレンズ 「AF-S NIKKOR 18-35mm f/3.5-4.5G ED」 です。
フルサイズようのレンズですが、ＡＰＳーＣフォーマットのカメラにも装着しても軽量なので取り回しは良いです。
外観目立つキズや打痕、塗装剥がれ、スレ等ありません。
レンズ内も、キズ、カビ、クモリ等なく、きれいな状態です。
各部、操作間もスムーズで、性能、機能上の不具合はありません。
純正の前後レンズキャップ、レンズフード、取説、布製収納袋が付いています。
また、当初から装着していた、77ｍｍ薄枠の保護用レンズフイターもお付けします。
梱包サイズは、６０サイズになります。
", "description_text": "ニコンFマウント用広角ズームレンズ 「AF-S NIKKOR 18-35mm f/3.5-4.5G ED」 です。フルサイズようのレンズですが、ＡＰＳーＣフォーマットのカメラにも装着しても軽量なので取り回しは良いです。外観目立つキズや打痕、塗装剥がれ、スレ等ありません。レンズ内も、キズ、カビ、クモリ等なく、きれいな状態です。各部、操作間もスムーズで、性能、機能上の不具合はありません。純正の前後レンズキャップ、レンズフード、取説、布製収納袋が付いていま...", "end_time": "2026-10-10T00:01:19+09:00", "highest_bidders_total": 1, "images": [ { "height": 696, "thumbnail_url": "https://auc-pctr.c.yimg.jp/i/auctions.c.yimg.jp/images.auctions.yahoo.co.jp/image/dr000/auc0210/user/f84677dcdc16b2417d018d167862b960fee70a2cb17cc77776a005db16825ea8/i-img1200x696-17915407300343ikeoxk200405.jpg?pri=l&w=214&h=214&up=0&nf_src=sy&nf_path=images/auc/pc/top/image/1.0.3/na_170x170.png&nf_st=200", "url": "https://auctions.c.yimg.jp/images.auctions.yahoo.co.jp/image/dr000/auc0210/user/f84677dcdc16b2417d018d167862b960fee70a2cb17cc77776a005db16825ea8/i-img1200x696-17915407300343ikeoxk200405.jpg", "width": 1200 }, { "height": 1099, "thumbnail_url": "https://auc-pctr.c.yimg.jp/i/auctions.c.yimg.jp/images.auctions.yahoo.co.jp/image/dr000/auc0210/user/f84677dcdc16b2417d018d167862b960fee70a2cb17cc77776a005db16825ea8/i-img1200x1099-17915407342162po3qhs12172.jpg?pri=l&w=214&h=214&up=0&nf_src=sy&nf_path=images/auc/pc/top/image/1.0.3/na_170x170.png&nf_st=200", "url": "https://auctions.c.yimg.jp/images.auctions.yahoo.co.jp/image/dr000/auc0210/user/f84677dcdc16b2417d018d167862b960fee70a2cb17cc77776a005db16825ea8/i-img1200x1099-17915407342162po3qhs12172.jpg", "width": 1200 }, { "height": 1119, "thumbnail_url": "https://auc-pctr.c.yimg.jp/i/auctions.c.yimg.jp/images.auctions.yahoo.co.jp/image/dr000/auc0210/user/f84677dcdc16b2417d018d167862b960fee70a2cb17cc77776a005db16825ea8/i-img1200x1119-17915407381656xxyapp153052.jpg?pri=l&w=214&h=214&up=0&nf_src=sy&nf_path=images/auc/pc/top/image/1.0.3/na_170x170.png&nf_st=200", "url": "https://auctions.c.yimg.jp/images.auctions.yahoo.co.jp/image/dr000/auc0210/user/f84677dcdc16b2417d018d167862b960fee70a2cb17cc77776a005db16825ea8/i-img1200x1119-17915407381656xxyapp153052.jpg", "width": 1200 }, { "height": 1200, "thumbnail_url": "https://auc-pctr.c.yimg.jp/i/auctions.c.yimg.jp/images.auctions.yahoo.co.jp/image/dr000/auc0210/user/f84677dcdc16b2417d018d167862b960fee70a2cb17cc77776a005db16825ea8/i-img1120x1200-179154074536802s4us05645.jpg?pri=l&w=214&h=214&up=0&nf_src=sy&nf_path=images/auc/pc/top/image/1.0.3/na_170x170.png&nf_st=200", "url": "https://auctions.c.yimg.jp/images.auctions.yahoo.co.jp/image/dr000/auc0210/user/f84677dcdc16b2417d018d167862b960fee70a2cb17cc77776a005db16825ea8/i-img1120x1200-179154074536802s4us05645.jpg", "width": 1120 }, { "height": 1200, "thumbnail_url": "https://auc-pctr.c.yimg.jp/i/auctions.c.yimg.jp/images.auctions.yahoo.co.jp/image/dr000/auc0210/user/f84677dcdc16b2417d018d167862b960fee70a2cb17cc77776a005db16825ea8/i-img1037x1200-17915407531008d5xcwj154057.jpg?pri=l&w=214&h=214&up=0&nf_src=sy&nf_path=images/auc/pc/top/image/1.0.3/na_170x170.png&nf_st=200", "url": "https://auctions.c.yimg.jp/images.auctions.yahoo.co.jp/image/dr000/auc0210/user/f84677dcdc16b2417d018d167862b960fee70a2cb17cc77776a005db16825ea8/i-img1037x1200-17915407531008d5xcwj154057.jpg", "width": 1037 } ], "init_price": 22000, "is_automatic_extension": false, "is_early_closing": true, "is_fleamarket": false, "is_offer": false, "is_worldwide_delivery": false, "left_time_seconds": -29756.835, "observed_at_ms": 1791587835920, "payment": { "credit_card": true, "net_bank": true, "paypay": true }, "price": 24000, "qa": { "answered": 0, "unanswered": 0 }, "quantity": 1, "related_items": null, "seller": { "display_name": "ois********", "good_rating": "99.5%", "is_ekyc_verified": false, "is_store": false, "listings_url": "https://auctions.yahoo.co.jp/seller/9jcQUKebFGczJZLsPU7wMH4WLBWWZ?user_type=c", "prefecture": "群馬県", "prefecture_code": "10", "rating_count": 1954, "user_id": "9jcQUKebFGczJZLsPU7wMH4WLBWWZ" }, "ship_schedule": "支払い手続きから1～2日で発送", "shipping": { "methods": [ { "id": "YAMATO_TAKKYUBIN_EASY", "is_flat_fee": false, "is_official_delivery": true, "name": "おてがる配送宅急便" }, { "id": "JP_YUPACK", "is_flat_fee": false, "is_official_delivery": true, "name": "おてがる配送ゆうパック" } ], "size": "TO_60CM", "weight": "TO_2KG" }, "shipping_fees": null, "start_time": "2026-10-09T19:30:32+09:00", "status": "closed", "title": "ニコンレンズ「AF-S NIKKOR 18-35mm f/3.5-4.5G ED」美品", "url": "https://auctions.yahoo.co.jp/jp/auction/b1247722169", "watch_count": 3 } ``` ### Search - Capability: `listings/search` - Description: Search Yahoo! Auctions Japan listings by keyword, category and/or seller. status OPEN lists live auctions; status CLOSED lists ended auctions with their final price and adds avg/min/max sold-price statistics for the whole result set. Prices are JPY integers, times are JST (+09:00) ISO strings, text is Japanese. - Instructions: Start here to find auction ids (then call item) or to get sold-price history for a keyword. Provide at least one of query, category_id or seller_id. - Cost: 5 credits per call - Capability file: [Search](https://firecrawl.dev/alexandria/agents/providers/auctions-yahoo-co-jp/listings/search) Accepted options: - `buy_now_only` (boolean): Only fixed-price (即決) listings. Example: `false` - `category_id` (number): Yahoo! Auctions category id (0 = all). Ids come from category_facets or from item/search category_path. Example: `10` - `conditions` (string[]): Item condition codes (NEW, USED10 unused-like ... USED80 heavily used). Example: `[]` - `free_shipping` (boolean): Only listings with free shipping. Example: `false` - `limit` (number): limit Example: `20` - `max_price` (number): Maximum current price in JPY. Example: `10` - `min_price` (number): Minimum current price in JPY. Example: `10` - `offset` (number): Result offset; pass next_offset from the previous page. Example: `0` - `query` (string): Keyword query (Japanese or Latin text). Example: `` - `seller_id` (string): Seller aucUserId as returned in items[].seller.user_id or item.seller.user_id. Pattern: ^[A-Za-z0-9_-]{1,40}$. Example: `` - `sort` (string): Site sort key. Default -RANKING for OPEN and -END_TIME for CLOSED. Example: `-RANKING` - `status` (string): OPEN = live auctions; CLOSED = ended auctions (sold-price history, statistics included). Example: `OPEN` Response schema example: ```json { "category_id": 0, "count": 3, "country": "JP", "currency": "JPY", "items": [ { "auction_id": "q1246996555", "bid_count": 17, "brand_id": 101345, "buy_now_price": null, "category": { "id": 2084044785, "name": "ニコン" }, "category_path": [ { "id": 0, "name": "オークション" }, { "id": 23632, "name": "家電、AV、カメラ" }, { "id": 23636, "name": "カメラ、光学機器" }, { "id": 23640, "name": "フィルムカメラ" }, { "id": 2084005101, "name": "一眼レフ" }, { "id": 2084041625, "name": "オートフォーカス" }, { "id": 2084044785, "name": "ニコン" } ], "condition": "USED60", "end_time": "2026-10-10T21:22:28+09:00", "image_url": "https://auc-pctr.c.yimg.jp/i/auctions.c.yimg.jp/images.auctions.yahoo.co.jp/image/dr000/auc0210/user/c201a3e994e1a418464e222604f0fbf378b7a7939e66c2d78af21ed436a7839f/i-img1200x800-17910838851936idexrk35.jpg?pri=l&w=300&h=300&up=0&nf_src=sy&nf_path=images/auc/pc/top/image/1.0.3/na_170x170.png&nf_st=200", "is_fixed_price": false, "is_fleamarket_item": false, "is_free_shipping": true, "prefecture_code": "28", "price": 28500, "seller": { "good_rating": "99.1%", "is_store": false, "user_id": "DLmz3Ty3mdgcSk5xyvuhP6ZVYJSqr" }, "shipping_fee": 0, "start_time": "2026-10-04T12:22:28+09:00", "title": "Nikon(ニコン) F3 AF ボディ + AF-NIKKOR 80mm F2.8 レンズ セット フィルムカメラ　【正常動作品】", "url": "https://auctions.yahoo.co.jp/jp/auction/q1246996555", "watch_count": 47 }, { "auction_id": "c1246991384", "bid_count": 0, "brand_id": 101345, "buy_now_price": 30000, "category": { "id": 2084044785, "name": "ニコン" }, "category_path": [ { "id": 0, "name": "オークション" }, { "id": 23632, "name": "家電、AV、カメラ" }, { "id": 23636, "name": "カメラ、光学機器" }, { "id": 23640, "name": "フィルムカメラ" }, { "id": 2084005101, "name": "一眼レフ" }, { "id": 2084041625, "name": "オートフォーカス" }, { "id": 2084044785, "name": "ニコン" } ], "condition": "USED20", "end_time": "2026-10-10T20:16:06+09:00", "image_url": "https://auc-pctr.c.yimg.jp/i/auctions.c.yimg.jp/images.auctions.yahoo.co.jp/image/dr000/auc0210/user/ac4144a43adb7a679571279c5412374293ee0394819f5f9d5f8a212740a46612/i-img1200x1200-17910764454325s8b7pn7432.jpg?pri=l&w=300&h=300&up=0&nf_src=sy&nf_path=images/auc/pc/top/image/1.0.3/na_170x170.png&nf_st=200", "is_fixed_price": true, "is_fleamarket_item": false, "is_free_shipping": true, "prefecture_code": "14", "price": 30000, "seller": { "good_rating": "100%", "is_store": false, "user_id": "5f4M8kAAxHfN1YEpEzL4eVNSonkKm" }, "shipping_fee": 0, "start_time": "2026-10-09T12:16:06+09:00", "title": "Nikon・F3・名品", "url": "https://auctions.yahoo.co.jp/jp/auction/c1246991384", "watch_count": 2 }, { "auction_id": "t1247448564", "bid_count": 28, "brand_id": 101345, "buy_now_price": null, "category": { "id": 2084044778, "name": "ニコン" }, "category_path": [ { "id": 0, "name": "オークション" }, { "id": 23632, "name": "家電、AV、カメラ" }, { "id": 23636, "name": "カメラ、光学機器" }, { "id": 23640, "name": "フィルムカメラ" }, { "id": 2084005101, "name": "一眼レフ" }, { "id": 2084041626, "name": "マニュアルフォーカス" }, { "id": 2084044778, "name": "ニコン" } ], "condition": "USED40", "end_time": "2026-10-10T22:54:29+09:00", "image_url": "https://auc-pctr.c.yimg.jp/i/auctions.c.yimg.jp/images.auctions.yahoo.co.jp/image/dr000/auc0210/user/264158e58d9515392309e4f97a5486e688c9a39f3e5db49bcf42f33adb0aa7d7/i-img1200x900-17913695034884jxetgk35.jpg?pri=l&w=300&h=300&up=0&nf_src=sy&nf_path=images/auc/pc/top/image/1.0.3/na_170x170.png&nf_st=200", "is_fixed_price": false, "is_fleamarket_item": false, "is_free_shipping": false, "prefecture_code": "28", "price": 96000, "seller": { "good_rating": "100%", "is_store": false, "user_id": "Co7gbTp83ka92b5knEBghyBhUXgaS" }, "shipping_fee": 780, "start_time": "2026-10-07T19:48:40+09:00", "title": "Nikon ニコン F3 HP ブラックボディ＋Micro Nikkor 55mm f:2.8＋レベルファインダー DW-3", "url": "https://auctions.yahoo.co.jp/jp/auction/t1247448564", "watch_count": 36 } ], "limit": 3, "next_offset": 3, "observed_at_ms": 1791587829999, "offset": 0, "query": "nikon f3", "seller_id": null, "sort": "-RANKING", "statistics": null, "status": "OPEN", "total": 6787 } ``` ### Seller - Capability: `listings/seller` - Description: Public profile of a Yahoo! Auctions seller by aucUserId: display name, store/eKYC flags, rating total and positive ratio, profile message and the URL of the seller's listings. Use search with seller_id for the listings themselves. - Instructions: After search or item returned a seller user_id and you need the seller's rating or profile. - Cost: 5 credits per call - Capability file: [Seller](https://firecrawl.dev/alexandria/agents/providers/auctions-yahoo-co-jp/listings/seller) Accepted options: - `user_id` (string, required): Seller aucUserId, e.g. G1isDADHY6ku2b2KoEY39uTc6ELGv. Pattern: ^[A-Za-z0-9_-]{1,40}$. Example: `` Response schema example: ```json { "country": "JP", "display_name": "佐々木", "icon_url": "https://s.yimg.jp/images/account/sp/img/display_name/user/128/07.png", "is_ekyc_verified": false, "is_speed_shipping": false, "is_store": false, "listings_url": "https://auctions.yahoo.co.jp/seller/G1isDADHY6ku2b2KoEY39uTc6ELGv?user_type=c", "observed_at_ms": 1791587840772, "profile_message": "はじめまして！\r\n当ページをご覧いただきまして、誠にありがとうございます！！\r\n丁寧・迅速な対応を心がけてまいりますので、よろしくお願いします。\r\nお受取後、初期不良等ございましたら、評価される前に一度ご連絡いただければ幸いです。\r\n\r\n人気の高い最新のデジカメ・レンズからマニアの方向けのフィルムカメラ、 初心者の方でも使いやすい一眼レフ、時には非常に珍しい商品まで、様々なカメラコレクションを出品する予定です。", "rating": { "good_ratio": 0.991, "status": "RATED", "total": 1590, "url": "https://auctions.yahoo.co.jp/jp/show/rating?auc_user_id=G1isDADHY6ku2b2KoEY39uTc6ELGv" }, "user_id": "G1isDADHY6ku2b2KoEY39uTc6ELGv" } ``` ### Suggest - Capability: `listings/suggest` - Description: Keyword completions Yahoo! Auctions offers for a search prefix (Japanese or Latin text). - Instructions: Before search when the exact Japanese term is unknown; an unknown prefix legitimately returns no keywords. - Cost: 5 credits per call - Capability file: [Suggest](https://firecrawl.dev/alexandria/agents/providers/auctions-yahoo-co-jp/listings/suggest) Accepted options: - `query` (string, required): query Example: `` Response schema example: ```json { "categories": [], "count": 10, "keywords": [ "ニコン", "nikon f100", "nikon f3", "nikon f2", "nikon f5", "nikon f", "nikon df", "nikon d850", "nikon f4", "nikon d200" ], "observed_at_ms": 1791587849741, "query": "nikon" } ```