buyee.jp APIbuyee.jp ↗
Search Yahoo Auctions Japan and Mercari Japan via the Buyee API. Retrieve item listings, prices, images, and details across Japanese marketplaces.
curl -X GET 'https://api.parse.bot/scraper/cbe679cb-de03-4482-8b06-9b336574f68f/search_all_platforms?limit=5&query=pokemon' \ -H 'X-API-Key: $PARSE_API_KEY'
Cross-platform search across multiple Japanese marketplaces (Yahoo Auctions, Mercari, Rakuma, etc.) simultaneously. Returns structured results with item details, prices, and platform information.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum results per platform |
| queryrequired | string | Search keyword (e.g. 'pokemon', 'nintendo') |
{
"type": "object",
"fields": {
"data": "array of platform result objects, each containing keywords, totalResultCount, totalPageCount, currentPageNumber, and results array with item details",
"status": "string, always 'success'"
},
"sample": {
"data": [
{
"results": [
{
"Bids": 0,
"site": "yahoo_auction",
"Image": "https://cdnyauction-pctr.buyee.jp/i/...",
"Title": "ポケモン フィギュア サンダー",
"BidOrBuy": 1400,
"AuctionID": "z605930176",
"CurrentPrice": 1400,
"FxCurrentPrice": 9.38
}
],
"keywords": [],
"totalPageCount": 110783,
"totalResultCount": 553912,
"currentPageNumber": 1
}
],
"status": "success"
}
}About the buyee.jp API
The Buyee.jp API gives developers access to 6 endpoints covering Japanese marketplace listings across Yahoo Auctions Japan (JDirectItems) and Mercari Japan. The search_all_platforms endpoint runs a single keyword query across multiple platforms simultaneously and returns per-platform result counts, page totals, and structured item arrays. Individual item endpoints expose price breakdowns, image arrays, condition details, and raw description HTML.
What the API covers
The API surfaces product listings from two major Japanese marketplaces: JDirectItems Auction (formerly Yahoo! Auctions Japan) and Mercari Japan, both accessible through Buyee's proxy shopping service. All six endpoints return a top-level status field and a data object. Search endpoints include pagination via a page parameter, and item-detail endpoints accept a platform-specific item ID — for example, IDs like x1234567890 for Yahoo Auctions or m1234567890 for Mercari.
Search endpoints
search_all_platforms accepts a query string and an optional limit per platform. Each platform's result object in the data array includes totalResultCount, totalPageCount, currentPageNumber, and a results array. For platform-specific searches, search_yahoo_auctions and search_mercari_japan offer paginated result sets with item titles, prices, and images. The Mercari search response also returns total count and items_per_page, making it straightforward to walk through large result sets.
Item detail endpoints
get_yahoo_auction_item returns a data object with id, title, images array, a details object, a prices object, time_remaining, and description_html. The time_remaining field is specific to the auction format and reflects how long the listing is active. get_mercari_item returns similar fields — id, title, price, images, details, and description_html — without a time-remaining field since Mercari listings are fixed-price.
Category browsing
get_yahoo_auction_categories requires no inputs and returns a result array of category objects, each containing a shop_list array. Categories span General products, Fashion, Toys & Games, and others available on Buyee. This endpoint is useful for building category-aware navigation or seeding search queries with known category slugs.
- Monitor Yahoo Auction Japan prices for specific collectibles by polling
search_yahoo_auctionsand tracking thepricesfield over time. - Build a cross-platform price comparison tool using
search_all_platformswith a single keyword and comparing results across platforms. - Fetch
time_remainingfromget_yahoo_auction_itemto alert users when auctions are about to close. - Aggregate Mercari Japan listings by walking paginated results from
search_mercari_japanusing thetotal countanditems_per_pagefields. - Populate a category browser using
get_yahoo_auction_categoriesto surface the full Buyee shop taxonomy. - Extract
description_htmlfrom individual item detail endpoints to parse Japanese product specifications or condition notes. - Track Mercari Japan item availability by checking whether
get_mercari_itemreturns a valid result for a known item ID.
| 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 Buyee have an official developer API?+
What does `search_all_platforms` return that platform-specific searches don't?+
search_all_platforms returns a data array where each element represents one platform and includes keywords, totalResultCount, totalPageCount, currentPageNumber, and a results array — all in a single call. Platform-specific endpoints like search_yahoo_auctions and search_mercari_japan return more targeted result structures and support the page parameter for deeper pagination, which search_all_platforms does not independently expose per platform.Does the API cover seller profiles or bidding history for Yahoo Auctions?+
Are Rakuma listings returned alongside Yahoo Auctions and Mercari?+
search_all_platforms describes coverage of 'Yahoo Auctions, Mercari, Rakuma, etc.' in its results array, but dedicated item-detail and paginated search endpoints exist only for Yahoo Auctions and Mercari. Rakuma results may appear in cross-platform searches, but there is no standalone get_rakuma_item endpoint. You can fork the API on Parse and revise it to add a dedicated Rakuma item-detail endpoint.How does pagination work across the search endpoints?+
search_yahoo_auctions and search_mercari_japan both accept an integer page parameter. The Mercari search response includes total count and items_per_page fields, which let you calculate the number of pages programmatically. Yahoo Auctions search returns a page field in the response but does not expose a total page count at the search level — use get_yahoo_auction_categories to scope queries and reduce result set sizes when needed.