Yahoo! Auctions Search — Live Listings by Keyword or Category
Send a keyword, a category ID, or both, and this source searches live Yahoo! Auctions Japan listings and returns them as data: title, price, buy-it-now price, bid count, end time, category, marketplace and seller.
{
"session_id": "11111111-1111-1111-1111-111111111111",
"kind": "yahoo_auctions_items_search",
"category": 23336,
"max_items": 2,
"start_page": 1,
"partial": false,
"human": "# Yahoo! Auctions items search\n\n- **category:** 23336\n- **max_items:** 2\n- **start_page:** 1\n- **Records returned:** 2\n- **Proxy traffic:** 116.2 KB",
"machine": {
"total_items": 2,
"first_item": {
"id": "t1246544651",
"url": "https://auctions.yahoo.co.jp/jp/auction/t1246544651",
"name": "国内即日発送 純正同等新品 CF-VZSU90JS バッテリー Panasonic Let'snote CF-LX3 CF-LX4 CF-LX5 CF-LX6 電池パック交換 パソコン battery",
"image": "https://auc-pctr.c.yimg.jp/i/auctions.c.yimg.jp/images.auctions.yahoo.co.jp/image/dr000/auc0210/user/ea68c0b66f1d69f7ca727a9e432c21a171907b450e705561bc23e63a6db8cac0/i-img1200x1200-179078134742034o6nh",
"price": 5490,
"buy_now_price": 5490,
"start_price": 5490,
"bid_count": 0,
"end_at": 1791382548,
"category_id": "2084039776",
"category_path_ids": [
"0",
"23336"
],
"marketplace": "yahoo_auctions",
"is_free_shipping": true,
"accepts_easy_payment": true,
"seller_id": "6Jm7prTSvFjBC8t5KxJX9jLbKrGen",
"seller_url": "https://auctions.yahoo.co.jp/seller/6Jm7prTSvFjBC8t5KxJX9jLbKrGen"
},
"items": [
{
"id": "t1246544651",
"url": "https://auctions.yahoo.co.jp/jp/auction/t1246544651",
"name": "国内即日発送 純正同等新品 CF-VZSU90JS バッテリー Panasonic Let'snote CF-LX3 CF-LX4 CF-LX5 CF-LX6 電池パック交換 パソコン battery",
"image": "https://auc-pctr.c.yimg.jp/i/auctions.c.yimg.jp/images.auctions.yahoo.co.jp/image/dr000/auc0210/user/ea68c0b66f1d69f7ca727a9e432c21a171907b450e705561bc23e63a6db8cac0/i-img1200x1200-179078134742034o6nh",
"price": 5490,
"buy_now_price": 5490,
"start_price": 5490,
"bid_count": 0,
"end_at": 1791382548,
"category_id": "2084039776",
"category_path_ids": [
"0",
"23336"
],
"marketplace": "yahoo_auctions",
"is_free_shipping": true,
"accepts_easy_payment": true,
"seller_id": "6Jm7prTSvFjBC8t5KxJX9jLbKrGen",
"seller_url": "https://auctions.yahoo.co.jp/seller/6Jm7prTSvFjBC8t5KxJX9jLbKrGen"
},
{
"id": "x1246536082",
"url": "https://auctions.yahoo.co.jp/jp/auction/x1246536082",
"name": "国内即日発送!! 純正同等新品!! FPCBP345Z バッテリー 富士通 LIFEBOOK UH55/H UH572 シリーズ 電池パック交換 パソコン 内蔵battery 単品",
"image": "https://auc-pctr.c.yimg.jp/i/auctions.c.yimg.jp/images.auctions.yahoo.co.jp/image/dr000/auc0210/user/ea68c0b66f1d69f7ca727a9e432c21a171907b450e705561bc23e63a6db8cac0/i-img1200x1200-17907813470244ral15",
"price": 3390,
"buy_now_price": 3390,
"start_price": 3390,
"bid_count": 0,
"end_at": 1791382548,
"category_id": "2084039776",
"category_path_ids": [
"0",
"23336"
],
"marketplace": "yahoo_auctions",
"is_free_shipping": true,
"accepts_easy_payment": true,
"seller_id": "6Jm7prTSvFjBC8t5KxJX9jLbKrGen",
"seller_url": "https://auctions.yahoo.co.jp/seller/6Jm7prTSvFjBC8t5KxJX9jLbKrGen"
}
],
"proxy_traffic_bytes": 119003
},
"total_points": 2
}- You send
- A keyword and/or category ID, with optional price, condition, region, seller, listing-type, shipping and sort filters
- You get back
- Matching live listings with title, price, buy-it-now price, bid count, end time, category and seller
- Coverage
- Live listings on Yahoo! Auctions Japan, and Yahoo! Flea Market when selected through the marketplace filter.
- Price
- 1 point per returned result, up to 500 per request — $1 per 1,000
- Billed per record actually returned, capped by max_items. A search that matches nothing costs nothing.
Ways to get this data
Three approaches teams use today, and where each one runs into trouble.
| Approach | What it takes | Cost | Trade-off |
|---|---|---|---|
| Searching the site by hand | Type the keyword, filter, scroll, copy | Free, and slow | Nobody keeps a watch list current this way |
| Building a scraper | Write it, host it, and repair it when Yahoo! changes the results page | Engineering time | A maintenance commitment for something that isn't your product |
| NeuralVerge | One request, keyword and filters as parameters | $1 per 1,000, misses not billed | A broad keyword returns a broad, and more expensive, result set |
What you get back
Every field in the response shown above.
| Field | Type | Description |
|---|---|---|
total_items | number | How many records were returned in this batch (capped by max_items). |
first_item | object | The first returned record, repeated for convenience. |
items | array | The returned records. |
id | string | Yahoo! Auctions listing ID. |
url | string | Direct link to the auction page. |
name | string | Listing title, in Japanese as posted. |
image | string | Primary photo URL. |
price | number | Current price in JPY. |
buy_now_price | number | Buy-it-now price in JPY, null when the listing has none. |
start_price | number | Opening price in JPY. |
bid_count | number | Number of bids placed. |
end_at | number | Auction end time as a Unix timestamp. |
category_id | string | Leaf category ID. |
category_path_ids | array | IDs of the category ancestors. |
marketplace | string | Which marketplace the listing is on, e.g. yahoo_auctions. |
is_free_shipping | boolean | Whether shipping is free. |
accepts_easy_payment | boolean | Whether the listing is flagged as accepting easy payment. |
seller_id | string | Seller ID, usable in the seller sources. |
seller_url | string | Link to the seller's page. |
How to run it
The same lookup works from the app, the API, or as a tool an agent can call mid-task.
Set max_items to cap spend; it accepts up to 500 per request. keyword is optional when a category is set. Use start_page to continue from where a previous request stopped.
curl -X POST https://api.neuralverge.ai/functions/v1/run-yahoo-auctions-items-search \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "keyword": "rolex", "max_items": 2 }'What teams use it for
Where this field shows up in an actual workflow.
Find items by keyword, condition and price ceiling, and sort by ending soonest to catch auctions before they close.
Run the same query on a schedule and watch how asking prices and bid counts move.
Search by category ID to see what is listed, and at what price, in a segment.
Take the seller IDs that keep appearing in a query and look them up in Yahoo! Auctions seller.
Coverage, freshness and limits
What this source covers, how fresh it is, and where it stops.
Live listings on Yahoo! Auctions Japan, and Yahoo! Flea Market when selected through the marketplace filter.
Read at request time.
This source returns publicly visible listing information, stamped with the query it was run for and a session id you can trace.
- —Results are listings that are live now; use closed items search for completed auctions and sold prices.
- —Result records carry seller ID and URL only; display name and profile come from the seller source.
- —Titles are in Japanese as posted, so keywords usually need to be Japanese to match them.
Questions, answered
Yes. keyword is optional when a category ID is set. Category IDs come from Yahoo! Auctions categories.
Related sources
See what comparable items actually sold for.
Full detail on one auction, live or completed.
Find the category IDs the search sources filter on.
Amazon, eBay, Walmart, AliExpress, Alibaba and Yahoo! Auctions product, seller and review data.
Try yahoo! auctions items search on your own data
One request format across every source in the catalog.