Buyee APIbuyee.jp ↗
Search Yahoo Auctions Japan, Mercari, and Rakuma listings via the Buyee API. Get item details, prices, images, seller profiles, and auction data.
What is the Buyee API?
The Buyee API covers 7 endpoints for searching and retrieving listings across major Japanese marketplaces, including Yahoo Auctions Japan and Mercari Japan. Use search_all_platforms to run a single keyword query across multiple platforms simultaneously, or call search_yahoo_auctions and search_mercari_japan individually for paginated results. Each endpoint returns structured item data including titles, prices, images, and item condition details.
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. Paginates internally per-platform; the limit controls how many results are returned per platform in a single call.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum results per platform |
| queryrequired | string | Search keyword (e.g. 'pokemon', 'nintendo') |
{
"type": "object",
"fields": {
"results": "array of platform result objects each containing keywords, totalResultCount, totalPageCount, currentPageNumber, and results array with item details"
},
"sample": {
"data": {
"results": [
{
"results": [
{
"Bids": 0,
"site": "mercari",
"Image": "//static.mercdn.net/thumb/item/jpeg/m88747587655_1.jpg",
"Title": "ポケモンキッズ",
"BidOrBuy": 555,
"AuctionID": "m88747587655",
"StartTime": "2026-06-11T18:24:39+09:00",
"CurrentPrice": 555
}
],
"keywords": [],
"totalPageCount": 41533,
"totalResultCount": 207661,
"currentPageNumber": 1
}
]
},
"status": "success"
}
}About the Buyee API
What the API Returns
The Buyee API exposes item data from Yahoo Auctions Japan (now JDirectItems), Mercari Japan, and Rakuma through a single interface. Cross-platform searches via search_all_platforms accept a query string and optional limit parameter, returning arrays of platform result objects that each include totalResultCount, totalPageCount, currentPageNumber, and a results array. Platform-specific search endpoints (search_yahoo_auctions, search_mercari_japan) support 1-based page pagination, with Yahoo Auctions returning up to ~50 items per page and Mercari returning up to ~97.
Item Detail Endpoints
get_yahoo_auction_item accepts a Yahoo Auctions item ID (e.g. d1232761048) and returns id, title, images, a prices object mapping price labels to values, a details object with fields like Item Condition and Number of Bids, time_remaining, and raw description_html. get_mercari_item works similarly for Mercari, returning price, title, images, a details object (Brand, Item Condition, Shipping Paid By), and description_html. Item IDs for both detail endpoints are obtained from their respective search endpoints.
Seller and Category Data
search_seller_profiles takes a query and optional limit (1–10) and surfaces seller details found across Yahoo Auctions and Mercari results — including platform, seller_id, seller_name, profile_url, and platform-specific rating fields. get_yahoo_auction_categories requires no inputs and returns a full category tree of Buyee's supported marketplaces, with each category containing a shop_list of shops with names, descriptions, and URLs — useful for discovering which platforms are available.
The Buyee API is a managed, monitored endpoint for buyee.jp — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when buyee.jp changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official buyee.jp API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Monitor auction prices for specific collectibles on Yahoo Auctions Japan using
search_yahoo_auctionsand trackingcurrent_priceandbidsfields. - Compare prices for the same product across Yahoo Auctions, Mercari, and Rakuma in a single call via
search_all_platforms. - Build a deal-alert tool that watches
time_remainingandbuyout_pricefields fromget_yahoo_auction_itemfor targeted item IDs. - Aggregate seller reputation data across platforms using
search_seller_profilesto surfaceratingandreview_countfor vendor research. - Enrich product listings with
description_html, condition details, and image arrays fromget_mercari_itemfor a resale catalogue. - Discover available Japanese marketplace categories and shops programmatically via
get_yahoo_auction_categoriesfor onboarding flows. - Track Mercari Japan inventory depth using the
totalanditems_per_pageresponse fields fromsearch_mercari_japan.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Buyee have an official developer API?+
What does `get_yahoo_auction_item` return beyond basic price information?+
details object with key-value pairs such as Item Condition, Starting Price, and Number of Bids; an images array of full-size image URLs; a prices object mapping labels to values; time_remaining as a string; and the full description_html content from the listing page. The item ID to pass in comes from search_yahoo_auctions results.Does the API return completed or sold auction listings?+
time_remaining auctions and live Mercari listings. You can fork this API on Parse and revise it to target completed-listing endpoints if that data becomes accessible.Can I filter Yahoo Auctions searches by price range, category, or item condition?+
search_yahoo_auctions endpoint currently accepts only query and page as inputs. Filtering by price range, category ID, or item condition is not currently supported as discrete parameters. You can fork this API on Parse and revise the endpoint to add those filter inputs.How does pagination work across the search endpoints?+
search_yahoo_auctions and search_mercari_japan both use 1-based integer page parameters. Yahoo Auctions returns up to ~50 items per page; Mercari returns up to ~97. The Mercari response includes a total field for the full result count. search_all_platforms paginates internally per platform and uses a limit parameter rather than a page number.