Yahoo! Auctions Catalog Product — Lowest Price & Live Listings
Send a Yahoo! Auctions Japan catalog product ID or URL and this source returns the product with its lowest current price, its lowest buy-it-now price and the live auctions that are matched to it.
{
"session_id": "11111111-1111-1111-1111-111111111111",
"kind": "yahoo_auctions_product",
"product": "a9f58050a0",
"product_id": "a9f58050a0",
"human": "# Yahoo! Auctions product\n\n- **Product:** a9f58050a0\n- **Proxy traffic:** 74.9 KB\n- **Name:** iPhone 12 128GB グリーン SIMフリー\n- **URL:** https://auctions.yahoo.co.jp/catalog/detail/a9f58050a0\n- **Lowest current price:** 22,001 JPY\n- **Lowest buy-it-now price:** 41,475 JPY\n- **Live auctions:** 15",
"machine": {
"product": {
"id": "a9f58050a0",
"url": "https://auctions.yahoo.co.jp/catalog/detail/a9f58050a0",
"name": "iPhone 12 128GB グリーン SIMフリー",
"image": "https://auctions.c.yimg.jp/images.auctions.yahoo.co.jp/image/dr000/auc-product/product/0/a9f58050a0.jpg",
"lowest_price": 22001,
"lowest_buy_now_price": 41475,
"product_category_id": "31765",
"is_appraisal": false,
"listing_count": 15,
"listings": [
{
"id": "w1246118434",
"url": "https://auctions.yahoo.co.jp/jp/auction/w1246118434",
"name": "★iPhone12 128GB グリーン MGHY3J/A",
"image": "https://auc-pctr.c.yimg.jp/i/auctions.c.yimg.jp/images.auctions.yahoo.co.jp/image/dr000/auc0209/user/dd875c55f590cac55b66e5a38c5c53524d5898a7556c820139501f134f3e5e21/i-img1200x1056-179050904661788jvjq",
"price": 22001,
"buy_now_price": null,
"bid_count": 10,
"end_at": 1791117423,
"condition": "slight_damage",
"category_id": "2084317599",
"region": "chiba",
"shipping_note": "＋送料440円（全国一律）",
"shipping_fee": 440,
"is_free_shipping": false,
"is_appraisal": false,
"seller_is_store": false,
"seller_good_rating": 99.7
},
{
"id": "j1220079531",
"url": "https://auctions.yahoo.co.jp/jp/auction/j1220079531",
"name": "MGHY3J/A iPhone 12 128GB グリーン SIMフリー",
"image": "https://auc-pctr.c.yimg.jp/i/auctions.c.yimg.jp/images.auctions.yahoo.co.jp/image/dr000/auc0202/user/4de85e37f2cc010ee64b5d765ea5758a79581da8e31f1e79dbb068181bd11d56/i-img1200x900-17714077087453mlp77w",
"price": 35400,
"buy_now_price": null,
"bid_count": 0,
"end_at": 1790948918,
"condition": "slight_damage",
"category_id": "2084317599",
"region": "kanagawa",
"shipping_note": "送料落札者負担",
"shipping_fee": 720,
"is_free_shipping": false,
"is_appraisal": false,
"seller_is_store": true,
"seller_good_rating": 99
}
]
},
"proxy_traffic_bytes": 76695
},
"total_points": 5
}- You send
- A Yahoo! Auctions catalog product ID or URL
- You get back
- Product name and image, lowest current and buy-it-now price, and the live listings matched to it
- Coverage
- Yahoo! Auctions Japan catalog products with a public catalog page.
- Price
- 5 pts — $5 per 1,000
- Charged only when the product resolves. A product ID or URL that doesn't resolve is not billed.
Ways to get this data
Three approaches teams use today, and where each one runs into trouble.
| Approach | What it takes | Cost | Trade-off |
|---|---|---|---|
| Browsing the catalog page by hand | Open the page and read through each listing | Free, and slow | Fine for one model, not for a price list |
| Building a scraper | Write it, host it, and repair it when Yahoo! changes the page | Engineering time | A maintenance commitment for something that isn't your product |
| NeuralVerge | One request per catalog product | $5 per 1,000, misses not billed | Reflects the listings live at request time; the cheapest one changes as auctions end |
What you get back
Every field in the response shown above.
| Field | Type | Description |
|---|---|---|
product | object | The catalog product, with the keys below. |
id | string | Catalog product ID. |
url | string | Link to the catalog page. |
name | string | Product name, in Japanese as shown. |
image | string | Catalog image URL. |
lowest_price | number | Lowest current price across the matched live listings, in JPY. |
lowest_buy_now_price | number | Lowest buy-it-now price across the matched listings, in JPY. |
product_category_id | string | Category ID the product is filed under. |
is_appraisal | boolean | Whether the product is flagged as carrying an authenticity appraisal. |
listing_count | number | Number of live listings matched to the product. |
listings | array | The matched listings, each with id, url, name, image, price, buy_now_price, bid_count, end_at, condition, category_id, region, shipping_note, shipping_fee, is_free_shipping, is_appraisal, seller_is_store and seller_good_rating. |
How to run it
The same lookup works from the app, the API, or as a tool an agent can call mid-task.
One catalog product per request. Take listing IDs from the listings array to run Yahoo! Auctions item for full detail on a single auction.
curl -X POST https://api.neuralverge.ai/functions/v1/run-yahoo-auctions-products \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "product": "a9f58050a0" }'What teams use it for
Where this field shows up in an actual workflow.
Read the lowest current and buy-it-now price for one exact model.
Compare shipping fees, conditions and seller types across the live listings for a model.
Re-run a catalog product on a schedule to see how the floor price moves.
Coverage, freshness and limits
What this source covers, how fresh it is, and where it stops.
Yahoo! Auctions Japan catalog products with a public catalog page.
Read at request time.
This source returns publicly visible catalog and listing information, stamped with the product ID it was read from and a session id you can trace.
- —The listings array is a sample of live listings and may be shorter than listing_count; the sample on this page is trimmed to two listings.
- —Prices and listings change as auctions end, so the result is a snapshot.
- —Only products that exist in Yahoo!'s catalog have a catalog ID.
Questions, answered
An entry Yahoo! Auctions uses to group listings of the same model. Its ID appears in the catalog page URL.
Related sources
Full detail on one auction, live or completed.
Search live listings by keyword or category.
See what comparable items actually sold for.
Amazon, eBay, Walmart, AliExpress, Alibaba and Yahoo! Auctions product, seller and review data.
Try yahoo! auctions product on your own data
One request format across every source in the catalog.