P Bandai APIp-bandai.com ↗
Access Premium Bandai Hong Kong pre-order listings and product search via API. Returns pricing in HKD, sale periods, images, and availability flags.
What is the P Bandai API?
The Premium Bandai Hong Kong API covers 2 endpoints for retrieving pre-order listings and searching products on p-bandai.com/hk. The list_preorder_items endpoint returns currently open pre-orders sorted by most recently opened, with HKD pricing, sale period dates, product images, and pre-order flags included on every result object. search_products adds keyword-driven queries with offset-based pagination and configurable sort order.
curl -X GET 'https://api.parse.bot/scraper/06e6e6ae-e9e7-4100-9301-fe989d214fde/list_preorder_items?limit=10' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace p-bandai-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Premium Bandai HK SDK — browse pre-orders and search products."""
from parse_apis.p_bandai_com_api import PBandai, SortType, ParseError
client = PBandai()
# List currently available pre-order items
for product in client.products.list_preorders(limit=3):
print(f"[PRE-ORDER] {product.name} — {product.price_currency} {product.price_amount}")
print(f" Sale period: {product.sale_start} to {product.sale_end}")
# Search for Gundam products sorted by newest arrivals
result = client.products.search(keyword="Gundam", sort=SortType.NEW_ARRIVAL, limit=3)
first_product = result.first()
if first_product:
print(f"\nNewest Gundam: {first_product.name}")
print(f" Code: {first_product.product_code}, Status: {first_product.sale_status}")
print(f" Images: {len(first_product.images)} available")
# Search with price sorting to find cheapest items
try:
for item in client.products.search(keyword="Dragon Ball", sort=SortType.PRICE_ASC, limit=2):
print(f" {item.name}: {item.price_currency} {item.price_amount}")
except ParseError as exc:
print(f"Request failed: {exc}")
print("exercised: products.list_preorders / products.search (multiple sorts) / ParseError")
Lists currently available pre-order items on Premium Bandai Hong Kong. Returns newly opened pre-orders that are still accepting orders, ordered by most recently opened. Each item includes pricing in HKD, sale period dates, product images, and pre-order flags.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of pre-order items to return (1-200). |
{
"type": "object",
"fields": {
"items": "array of pre-order product objects",
"total_count": "integer"
},
"sample": {
"data": {
"items": [
{
"name": "POKEMON SCALE WORLD SINNOH REGION DIALGA W/O GUM",
"flags": [
"PRE_ORDER"
],
"images": [
"https://p-bandai.com/files/seller-products/ASP0005652001/rHor3XLJxxdP690pHLYx.jpg"
],
"name_zh": "POKEMON SCALE WORLD SINNOH REGION DIALGA W/O GUM",
"sale_end": "2026-07-12T15:59:59.999Z",
"sale_start": "2026-07-02T08:00:00Z",
"sale_status": "On",
"price_amount": 830,
"product_code": "A2837362001",
"product_type": "PreOrder",
"price_currency": "HKD",
"area_product_no": "AAP0005652001HK"
}
],
"total_count": 3
},
"status": "success"
}
}About the P Bandai API
Pre-order Listings
The list_preorder_items endpoint returns items that are actively accepting pre-orders on Premium Bandai Hong Kong, ordered from most recently opened. Each object in the items array includes HKD pricing, sale period start and end dates, product images, and boolean pre-order flags. The total_count field tells you how many open pre-orders exist at query time. The limit parameter accepts values from 1 to 200, so you can pull a broad snapshot or a narrow slice in a single call.
Product Search
The search_products endpoint accepts a required keyword string and returns matching available and upcoming pre-order products. Pagination is handled manually via offset and limit (1–40 results per page); both values echo back in the response alongside keyword, sort_type, and total_count, making it straightforward to walk through large result sets. The sort_type parameter controls the ordering of results, useful when you want to surface newest listings or price-sorted output.
Response Fields
Both endpoints return items arrays of product objects containing consistent fields: HKD pricing, sale period dates, product image URLs, and pre-order status indicators. total_count is present on both responses, enabling accurate pagination calculations and inventory monitoring over time.
Coverage Scope
This API is scoped to the Hong Kong storefront of Premium Bandai (p-bandai.com/hk). Listings reflect what is publicly accessible on that regional storefront — pre-orders that are open or upcoming. Product data for other regional Premium Bandai storefronts (Japan, US, Taiwan, etc.) is outside the current scope.
The P Bandai API is a managed, monitored endpoint for p-bandai.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when p-bandai.com 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 p-bandai.com 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 newly opened Premium Bandai HK pre-orders sorted by recency using
list_preorder_items - Build a price tracker for HKD-denominated Bandai collectibles across sale periods
- Search for specific Gundam or Kamen Rider product lines via keyword and paginate through results
- Alert users when a searched product keyword returns new pre-order listings
- Aggregate sale period dates to forecast pre-order windows for upcoming releases
- Compile product image URLs and metadata for a fan catalog or comparison tool
- Track
total_countchanges over time to detect when pre-order slots open or close
| 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 | 100 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 Premium Bandai have an official public developer API?+
What does `list_preorder_items` return, and how is it different from `search_products`?+
list_preorder_items returns all currently open pre-orders in a single ranked list (newest first), up to 200 items, with no keyword filter. search_products requires a keyword and supports offset-based pagination up to 40 items per page, making it better suited for targeted lookups. Both return HKD pricing, sale period dates, image URLs, and pre-order flags.