Yahoo! Auctions Japan Search API Documentation Search public auction listings by keyword or category. Set status to sold for closed and sold prices. Filter by condition and price range, sort by price or newest and page through results. Each item has id, url, title, price in JPY, bids, watch count, condition, seller, end and start time as ISO 8601 with +09:00, and full-size image URLs. Flea-market rows are excluded. Ids feed the item endpoint unchanged. Each successful request costs 1 credit. A failed request is never billed.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
8 optional filters available.
string
Optional
Search keywords, for example camera. Required unless category is sent.
coffee shops
string
Optional
Category id from search results. Up to five comma-separated ids.
example
string
Optional
Comma list of NEW, USED20, USED10 or USED5.
example
number
Optional
Lowest price in JPY.
10
number
Optional
Highest price in JPY.
10
string
Optional
open (default) or sold.
example
string
Optional
relevance, price_asc, price_desc or newest.
relevance
integer
Optional
Page number, 1 to 100. Defaults to 1.
1
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
success
{
"data": {
"page": 1,
"items": [
{
"id": "v1251814298",
"url": "https://auctions.yahoo.co.jp/jp/auction/v1251814298",
"bids": 3,
"price": 12000,
"title": "Camera lens",
"images": [
"https://auctions.c.yimg.jp/images.auctions.yahoo.co.jp/image/1200x1200/lens.jpg"
],
"seller": {
"name": "camera-shop",
"rating": 998,
"is_store": true
},
"status": "open",
"currency": "JPY",
"end_time": "2026-11-18T21:08:32+09:00",
"condition": {
"id": "USED20",
"name": "Like new"
},
"sold_price": null,
"original_price": 15000
}
],
"query": "camera",
"total": 789000,
"status": "open",
"has_next": true,
"per_page": 50
},
"success": true
}
Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A filter is missing or invalid. Upstream is not called and the request is not billed.
{
"errors": {
"condition": [
"Use one or more of NEW, USED20, USED10, USED5."
]
},
"message": "The request validation failed"
}Transport Unavailable
Upstream did not answer after several tries. The request is not billed.
{
"error": {
"code": "transport_unavailable",
"message": "Yahoo! Auctions could not be reached right now. The request is not billed. Try again."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.