Japan Toreca APIjapan-toreca.com ↗
Access trading card pack (oripa) listings from Japan Toreca Center. Filter by category, tag, and availability. Get prices, titles, and pack metadata.
What is the Japan Toreca API?
The Japan Toreca Center API provides access to oripa lottery pack listings through 1 endpoint, list_packs, which returns an array of pack objects each containing id, title, category, price, tags, and availability status. You can filter results by trading card game category, tag labels such as 'new', 'psa_10', or 'box', and control whether sold-out packs appear in the response.
curl -X GET 'https://api.parse.bot/scraper/6587314d-f9e9-4606-a3c8-d8562dc767cf/list_packs?category=pokemon&include_soldout=false' \ -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 japan-toreca-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: japan_toreca_com_api SDK — bounded, re-runnable; every call capped."""
from parse_apis.japan_toreca_com_api import JapanToreca, Category, InvalidInput
client = JapanToreca()
# List Pokemon packs with default settings
for pack in client.packs.list(category=Category.POKEMON, limit=3):
print(pack.title, pack.price, pack.left_cards, pack.total_cards)
# Fetch One Piece packs including sold-out ones
for pack in client.packs.list(category=Category.ONEPIECE, include_soldout="true", limit=3):
print(pack.title, pack.is_sold_out, pack.like_count)
# Handle invalid input
try:
result = client.packs.list(category=Category.POKEMON, include_soldout="invalid", limit=1).first()
except InvalidInput as e:
print("invalid input:", e)
print("exercised: packs.list")
List trading card packs (oripa lotteries) available on Japan Toreca Center. Returns all currently available packs for the specified category with their pricing, availability, and tag metadata. Results are returned in a single page ordered by the platform's default recommendation or specified sort.
| Param | Type | Description |
|---|---|---|
| tag | string | Filter by tag type (e.g. 'few', 'new', 'login_bonus', 'psa_10', 'box', '319', 'fifty_fifty', 'advanced', 'intermediate', 'beginners'). Empty string returns all. |
| sort_by | string | Sort order for results. Empty string uses platform default (recommended). Other values are forwarded to the API. |
| category | string | Trading card game category to filter packs by. |
| include_soldout | string | Whether to include sold-out packs. Accepts 'true' or 'false'. |
{
"type": "object",
"fields": {
"packs": "array of pack objects with id, title, category, price, tags, availability",
"total": "integer count of packs returned"
},
"sample": {
"data": {
"packs": [
{
"id": 92287,
"tags": [
{
"name": "新規登録者限定",
"type": "new_user_only",
"name_en": "New user exclusive"
},
{
"name": "新着",
"type": "new",
"name_en": "New"
}
],
"price": 1,
"title": "新規登録から7日間限定 Platinum Legacy!!",
"sale_to": "2100-01-01T00:00:00Z",
"category": "pokemon",
"sale_from": "2026-07-30T17:10:01+09:00",
"left_cards": 6,
"like_count": 1,
"is_sold_out": false,
"total_cards": 10,
"display_price": "1",
"payment_method": "coin",
"header_image_url": "https://japan-toreca-strapi.imgix.net/20260702_Premium_Challenge_X_85b3e94c53.jpg?auto=format%2Ccompress",
"recent_user_count": 4,
"minimum_exchange_point": 1000
}
],
"total": 161
},
"status": "success"
}
}About the Japan Toreca API
What the API Returns
The list_packs endpoint returns all currently available oripa lottery pack listings from Japan Toreca Center. Each pack object in the response includes a unique id, title, category (the trading card game type), price, tags, and an availability field indicating whether the pack is still purchasable. The total field in the response gives the integer count of packs returned for the current query.
Filtering and Sorting
The endpoint accepts four optional parameters. The category parameter narrows results to a specific trading card game type. The tag parameter filters by platform-defined labels — known values include few (limited remaining), new, login_bonus, psa_10, box, 319, fifty_fifty, advanced, and inte. The include_soldout parameter accepts 'true' or 'false' to control whether exhausted packs appear. The sort_by parameter changes the ordering; leaving it empty applies Japan Toreca Center's default recommendation order.
Coverage and Scope
Results reflect the platform's current live listings in a single page response — there is no cursor or pagination parameter. The data covers the full breadth of pack types listed on Japan Toreca Center at the time of the request, making it suitable for monitoring inventory changes, tracking newly tagged packs, or building category-specific price comparisons.
The Japan Toreca API is a managed, monitored endpoint for japan-toreca.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when japan-toreca.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 japan-toreca.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 when new oripa packs (tagged 'new') become available across all trading card categories
- Track price distribution of currently available packs within a specific card game category
- Alert users when limited-stock packs (tagged 'few') appear before they sell out
- Build a PSA 10 pack tracker by filtering with the 'psa_10' tag
- Compare pack availability across categories to identify which card types have the most active inventory
- Aggregate tag frequency across listings to understand current promotion types on the platform
| 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 Japan Toreca Center have an official developer API?+
What does the 'tags' field in a pack object contain?+
tags field is an array of platform-defined label strings attached to a pack listing. Known tag values include 'new', 'few', 'login_bonus', 'psa_10', 'box', '319', 'fifty_fifty', and 'advanced'. Tags reflect how Japan Toreca Center categorizes packs on its platform and can be used as a filter input via the tag parameter on the list_packs endpoint.Does the API return individual card contents or prize odds for each pack?+
Does the API support paginating through large result sets?+
list_packs endpoint returns results in a single response without a pagination cursor or page parameter. All packs matching the supplied filters are returned at once. If you need to segment results incrementally, the category and tag filters can be used to scope individual requests.