p-bandai.jp APIp-bandai.jp ↗
Access Premium Bandai's exclusive product catalog via API. Search by keyword, character, or genre. Retrieve prices, images, labels, and pre-order status.
curl -X GET 'https://api.parse.bot/scraper/ea02a033-95e2-40f9-89c9-4c13960430ec/search_products?page=1&query=Gundam' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products on p-bandai.jp using keyword queries. Returns paginated product listings with name, price, image, and labels.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| queryrequired | string | Search keyword (e.g. 'Gundam', 'ガンダム') |
{
"type": "object",
"fields": {
"page": "integer current page number",
"items": "array of product objects with product_id, name, price, image_url, product_url, labels",
"total_count": "integer total number of matching products"
},
"sample": {
"data": {
"page": 1,
"items": [
{
"name": "ＭＧ 1/100 フルアーマー・ガンダム（GUNDAM THUNDERBOLT…",
"price": "￥8,030",
"labels": [],
"image_url": "//bandai-a.akamaihd.net/bc/img/model/b/1000242716_1.jpg",
"product_id": "1000242716",
"product_url": "https://p-bandai.jp/item/item-1000242716/"
}
],
"total_count": 0
},
"status": "success"
}
}About the p-bandai.jp API
The Premium Bandai API provides 7 endpoints covering product search, detail retrieval, and catalog filtering across p-bandai.jp's exclusive merchandise listings. The search_products endpoint accepts Japanese or English keywords and returns paginated results with product IDs, formatted yen prices, image URLs, and status labels. Companion endpoints surface newly listed and upcoming pre-order items, while filter endpoints let you scope results to a specific character series or merchandise genre.
Search and Browse the Catalog
The search_products endpoint accepts a query string — either romaji like 'Gundam' or native Japanese like 'ガンダム' — and returns a paginated list of matching items. Each item in the items array includes product_id, name, price (formatted with the yen symbol), image_url, product_url, and a labels array that carries status strings such as shipping dates and pre-order indicators. The total_count field lets you calculate how many pages to fetch. The optional page integer parameter is available on every listing endpoint.
Product Details and Status Labels
get_product_details accepts a product_id obtained from any listing endpoint and returns the full image gallery (images array), the formatted price, and the complete labels array for that item. Labels are the primary signal for availability state — they encode information like estimated ship dates and whether an item is currently accepting pre-orders. The endpoint does not currently return a structured stock count or a machine-readable availability flag; status is inferred from label text.
Filter by Character or Genre
get_search_filters returns two arrays: characters (each with id and name) and genres (each with id and name). These IDs feed directly into filter_by_character and filter_by_genre. For example, passing char_id: 'c2933' scopes results to アークナイツ merchandise, while genre_id: '0013' scopes to おもちゃ・キャラクター玩具. You can optionally pass a query to get_search_filters to retrieve facets relevant to a specific search context rather than the full catalog.
New and Upcoming Releases
search_new_products returns the most recently listed items sorted newest-first, and search_upcoming_products returns items not yet on sale. Both share the same paginated response shape as the main search endpoint. These two endpoints are useful for monitoring pre-order windows without running a keyword query.
- Track pre-order openings for specific character series using
search_upcoming_productsfiltered bychar_id. - Build a price-monitoring tool by periodically calling
get_product_detailsand comparing the returnedpricefield. - Populate a collector's wishlist app with image galleries and labels from the
imagesandlabelsarrays. - Aggregate newly listed exclusives with
search_new_productsto send release-alert notifications. - Build a genre browser by fetching
genresfromget_search_filtersand feeding eachidintofilter_by_genre. - Cross-reference Premium Bandai prices with secondary market data by exporting
product_id,name, andpricefrom keyword searches. - Monitor the full catalog size for a character franchise over time using
total_countfromfilter_by_character.
| 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 p-bandai.jp have an official public developer API?+
What do the `labels` fields actually contain, and can I filter by them?+
labels array contains human-readable strings such as estimated ship dates and pre-order status indicators. Labels are returned as plain text and are not normalized to machine-readable codes. The current endpoints do not accept a label value as a filter parameter. The API covers filtering by character, genre, keyword, and availability bucket (new vs. upcoming). You can fork it on Parse and revise to add a label-based filter endpoint.Does the API return product reviews or user ratings?+
How current are the product listings — is data cached?+
search_upcoming_products at intervals is the practical approach rather than relying on any stated refresh guarantee.Can I retrieve products from a specific Bandai sub-brand or series (e.g., METAL BUILD, S.H.Figuarts)?+
search_products endpoint accepts a keyword query, so passing a sub-brand name like 'METAL BUILD' will return matching items. More structured sub-brand filtering is not currently supported as a distinct filter facet. You can fork the API on Parse and revise it to add a sub-brand or category parameter if the site exposes that facet.