auctions.yahoo.co.jp APIauctions.yahoo.co.jp ↗
Search active and completed Yahoo Auctions Japan listings, retrieve item details, seller profiles, and identify underpriced items against 180-day market averages.
curl -X GET 'https://api.parse.bot/scraper/db1cf3fd-add4-4ac6-a70d-1b9d1c8e99d7/search_listings?limit=5&query=%E3%82%AB%E3%83%A1%E3%83%A9' \ -H 'X-API-Key: $PARSE_API_KEY'
Search active auction and fixed-price listings by keyword and category. Returns paginated results with item title, price, ID, URL, and thumbnail image.
| Param | Type | Description |
|---|---|---|
| sort | string | Sort field: 'new', 'end', 'bids', 'price' |
| limit | integer | Number of results per page (max 50) |
| order | string | Sort order: 'a' (ascending), 'd' (descending) |
| query | string | Search keyword |
| auccat | string | Category ID |
| offset | integer | Pagination offset (increments of limit) |
| condition | string | Item condition: 'new' or 'used' |
| max_price | integer | Maximum price in Yen |
| min_price | integer | Minimum price in Yen |
{
"type": "object",
"fields": {
"items": "array of listing objects with title, id, url, price, image_url",
"total": "integer total result count"
},
"sample": {
"data": {
"items": [
{
"id": "r1228403481",
"url": "https://auctions.yahoo.co.jp/jp/auction/r1228403481",
"price": 3680,
"title": "バックカメラ 24V対応 トラック 等に",
"image_url": "https://auc-pctr.c.yimg.jp/i/auctions.c.yimg.jp/images.auctions.yahoo.co.jp/image/dr000/auc0205/user/example/i-img800x800-1777.jpg"
}
],
"total": 0
},
"status": "success"
}
}About the auctions.yahoo.co.jp API
This API exposes 5 endpoints covering Yahoo Auctions Japan (auctions.yahoo.co.jp), letting you search active and completed listings, pull full item details, assess seller reputation, and surface underpriced deals. The compare_market_price endpoint alone bundles market-average calculation with active-listing filtering, returning only items priced below 80% of the 180-day sold average — a figure derived directly from search_completed_listings stats.
Search and Historical Pricing
search_listings accepts keyword (query), category (auccat), condition (new or used), max_price, sort field (new, end, bids, price), and a paginated offset. Each result object includes title, id, url, price, image_url, and a total count for page math. search_completed_listings targets sold items and returns the same item shape plus a stats object with min_price, avg_price, and max_price computed over a 180-day window — the primary way to establish fair market value for any keyword on the platform.
Item and Seller Detail
get_listing_detail takes a single item_id (e.g. r1228403481) and returns the full record: title, price, bid_count, and seller_id. That seller_id feeds directly into get_seller_profile, which returns the seller's display_name, integer rating_score (total feedback count), and good_ratio (a 0.0–1.0 positive feedback ratio). Together these two endpoints give you enough data to evaluate both the item and the counterparty before bidding.
Bargain Detection
compare_market_price is a compound endpoint: supply a query string and it returns market_avg_price (the 180-day average) alongside underpriced_items — an array of active listings each priced below 80% of that average. Each underpriced item carries title, id, url, price, image_url, and the market_avg_price for inline comparison. This is the most direct route to opportunistic sourcing without manually joining results from two separate endpoints.
- Track resale values for specific product categories by polling
search_completed_listingsstats over time - Build a deal-alert tool that calls
compare_market_priceon a watchlist of keywords and flags items below the 80% threshold - Evaluate seller trustworthiness before bidding by chaining
get_listing_detail→get_seller_profileforgood_ratioandrating_score - Aggregate Japanese market pricing for electronics or collectibles using the
min_price,avg_price, andmax_pricefields from completed listings - Filter active auction inventory by
conditionandmax_priceto build a curated feed of budget new-in-box items - Compare bid activity across listings by sorting
search_listingsbybidsdescending to find high-demand items
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Yahoo Auctions Japan have an official developer API?+
What does the `stats` object in `search_completed_listings` actually represent?+
min_price, avg_price, and max_price — calculated across completed (sold) listings matching the query over the past 180 days. These are aggregate figures across all returned results, not per-item stats.Does the API return auction images or description text beyond the title?+
search_listings returns image_url (thumbnail) and get_listing_detail returns title, price, and bid_count. Full item description text, multiple image galleries, and shipping details are not currently exposed. You can fork the API on Parse and revise get_listing_detail to add those fields.How does pagination work across the search endpoints?+
search_listings and search_completed_listings both accept an offset parameter that increments by the value of limit (max 50 per page). The total field in search_listings responses tells you how many results exist so you can calculate the number of pages needed.Can I retrieve bid history or the list of individual bidders for an auction?+
get_listing_detail returns only the aggregate bid_count. You can fork the API on Parse and revise it to add a bid-history endpoint that returns individual bid records.