Rebel APIrebel.pl ↗
Search and fetch full product data from rebel.pl's 11,000-product catalogue: board games, RPGs, TCGs, puzzles, pricing, EAN, images, and faceted filters.
What is the Rebel API?
The rebel.pl API exposes two endpoints covering roughly 11,000 products across rebel.pl's Polish hobby retail catalogue — board games, RPG books, TCGs, miniatures, puzzles, and accessories. The search_products endpoint returns paginated product summaries with facet counts for authors, publishers, languages, and subcategories. The get_product endpoint delivers full product detail including EAN/UPC, gallery images, game mechanics tags, designer and illustrator credits, and current PLN pricing.
curl -X GET 'https://api.parse.bot/scraper/5f825d6a-6ade-4ca2-8880-3be8b05db76e/search_products?query=dixit&category=100' \ -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 rebel-pl-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: rebel.pl catalogue SDK — bounded, re-runnable."""
from parse_apis.rebel_pl_api import (
Rebel, Sort, RootCategory, Availability, ProductNotFound,
)
client = Rebel()
# Browse board games currently in stock, newest first.
for item in client.product_summaries.search(
category=RootCategory.BOARD_GAMES,
availability=Availability.IN_STOCK,
sort=Sort.NEWEST,
limit=5,
):
print(item.title, item.price, item.currency)
# Search for a specific game and drill into its full details.
hit = client.product_summaries.search(query="dixit", limit=1).first()
if hit is not None:
product = hit.details()
print(product.title, product.price, product.currency)
print("Authors:", ", ".join(product.authors))
print("EAN:", product.ean)
if product.rating is not None:
print(f"Rating: {product.rating.average}/5 ({product.rating.count} votes)")
for tag in product.tags:
print(f" [{tag.type}] {tag.name}")
# Point lookup by a known product_id, with typed error handling.
try:
detail = client.products.get(product_id=hit.product_id)
print(detail.title, detail.availability)
except ProductNotFound:
print("Product no longer exists.")
print("exercised: product_summaries.search / details / products.get")
Searches the complete rebel.pl catalogue (about 11,000 products) and returns one page of product summaries plus facet counts. With no filters and an empty query it lists the whole catalogue, so the entire offer can be walked page by page. Each item carries the numeric product_id accepted by get_product, title, one-line short_description, main image URL, product URL, current price and pre-discount old_price in PLN, availability code, promotional labels, root/main category (id + Polish name), all category paths the product is filed under, rating, tag slugs (mechanics, themes, skills, content_types, epochs) and min/max players, age and playing time (null for products such as accessories that have none). The facets object returns counts for the top 100 authors, publishers, subcategories, languages, availability codes and labels within the current result set; author and publisher facet keys are the exact strings accepted by the author and publisher filters. Pagination is caller-controlled through page (1-based, default 1) and hits_per_page (default 50, capped at 200); pages and has_more describe the remaining pages. Sorting defaults to the site's popularity order. Zero matches is a valid empty result. Two upstream round trips per call.
| Param | Type | Description |
|---|---|---|
| page | integer | 1-based page number. |
| sort | string | Result ordering; default is the site's popularity order. |
| label | string | Promotional label filter (e.g. only discounted or new products). Omitted = any. |
| query | string | Free-text search phrase matched against product names and short descriptions (Polish titles, typo-tolerant). Empty or omitted lists everything matching the other filters. |
| author | string | Exact game designer name as listed on the site, e.g. one of the keys of facets.authors or a value of get_product.authors. Unknown names return an empty result. |
| category | string | Root category of the site's top navigation. Omitted = all categories. |
| language | string | Edition language filter. Omitted = any. |
| publisher | string | Exact publisher name as listed on the site (a key of facets.publishers or a value of get_product.publishers). Unknown names return an empty result. |
| availability | string | Stock status filter. Omitted = any. |
| hits_per_page | integer | Items per page; values above 200 are clamped to 200. |
{
"type": "object",
"fields": {
"page": "the page returned (1-based)",
"items": "array of product summaries; product_id is the key for get_product, prices are PLN numbers, players/age/playing_time are {min,max} objects or null, mechanics/themes/skills/content_types/epochs are arrays of English tag slugs",
"pages": "total number of pages at this hits_per_page",
"total": "total number of products matching the query and filters",
"facets": "object with authors, publishers, subcategories ({name: {id, count}}), languages, availability and labels count maps for the current result set",
"has_more": "true when a later page exists",
"hits_per_page": "effective page size after clamping"
},
"sample": {
"data": {
"page": 1,
"items": [
{
"age": {
"max": 99,
"min": 8
},
"url": "https://www.rebel.pl/gry-planszowe/dixit-2001605.html",
"image": "https://files.rebel.pl/products/100/606/_2001605/rebel-gra-rodzinna-dixit-box-3d-2024.png",
"price": 149.95,
"title": "Dixit",
"epochs": [],
"labels": [
"promocja",
"bestseller"
],
"rating": {
"count": 213,
"average": 4.71
},
"skills": [
"storytelling"
],
"themes": [
"educational",
"humor"
],
"players": {
"max": 8,
"min": 3
},
"currency": "PLN",
"mechanics": [
"voting",
"simultaneous-action-selection"
],
"old_price": null,
"product_id": "2001605",
"availability": "not-available",
"playing_time": {
"max": 30,
"min": 30
},
"release_date": null,
"content_types": [
"card-game"
],
"main_category": {
"id": "606",
"name": "Rodzinne gry planszowe"
},
"root_category": {
"id": "100",
"name": "Gry planszowe i towarzyskie"
},
"category_paths": [
"Gry planszowe i towarzyskie",
"Promocje",
"Gry planszowe i towarzyskie > Rodzinne gry planszowe"
],
"short_description": "Obraz wart tysiąca słów!"
}
],
"pages": 9,
"total": 26,
"facets": {
"labels": {
"promocja": 1,
"bestseller": 2
},
"authors": {
"Théo Rivière": 1,
"Jean-Louis Roubira": 19
},
"languages": {
"pl": 20
},
"publishers": {
"Rebel": 19,
"Gamegenic": 2
},
"availability": {
"in-stock": 17,
"preorder": 2,
"not-available": 7
},
"subcategories": {
"Rodzinne gry planszowe": {
"id": "606",
"count": 6
}
}
},
"has_more": true,
"hits_per_page": 3
},
"status": "success"
}
}About the Rebel API
Searching the Catalogue
The search_products endpoint accepts free-text query input matched against Polish product names and short descriptions with typo tolerance. You can narrow results with category (top-level site navigation), language (edition language), publisher, author, and label (promotional flags such as discounted or new). Omitting all filters and passing an empty query walks the entire catalogue page by page — pages and has_more drive pagination, and total tells you the full match count. Each result item includes a numeric product_id needed for get_product, along with PLN prices and structured {min, max} objects for player count, age, and playing time.
Facets for Dynamic Filtering
Every search_products response includes a facets object containing count maps for authors, publishers, subcategories, languages, availability, and labels — scoped to the current query and filters. These are useful for building filter UIs or discovering the exact string values required by the author and publisher parameters, which must match the site's canonical spellings.
Full Product Detail
Passing a product_id to get_product returns the complete product record: title, url, description (plain text) and description_html, authors, illustrators, publishers, ean, weight, edition, rating (average and count), and an images array of gallery URLs. The tags array categorises the product by mechanic, theme, skill, content, and epoch slugs — useful for structured hobby-catalogue applications. Fields are null when the source page does not carry that data.
The Rebel API is a managed, monitored endpoint for rebel.pl — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when rebel.pl 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 rebel.pl 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?+
- Building a Polish board game price tracker using
pricefields returned bysearch_productsandget_product - Populating a hobby-store inventory system with EAN barcodes and publisher metadata from
get_product - Creating a board game recommendation engine filtered by mechanics and themes from the
tagsarray inget_product - Generating a searchable multilingual catalogue index using the
languagefilter andeditionfield - Monitoring promotional labels and availability counts via the
facets.labelsandfacets.availabilitymaps insearch_products - Aggregating designer discographies by querying
search_productswith theauthorparameter and collecting full credits fromget_product.authorsandget_product.illustrators - Syncing a third-party wishlist app with current rebel.pl listings by walking all pages with no filters
| 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 rebel.pl offer an official developer API?+
What does `get_product` return for unrated or minimally described products?+
rating returns {average: null, count: null} for unrated products, and ean, weight, and edition are null when absent. The authors and illustrators arrays may be empty for products without credited designers.How do I find the exact string values to use for the `author` and `publisher` filter parameters?+
facets object in every search_products response contains authors and publishers count maps keyed by the canonical name strings the filters expect. You can also read get_product.authors and get_product.publishers from any matching product. Passing a name that doesn't match the site's canonical spelling will return zero results.Does the API include user reviews or wish-list data?+
Is the full catalogue reachable, or are some products unavailable?+
search_products endpoint covers approximately 11,000 products and supports full catalogue traversal with no query or filters. Products that exist in the catalogue but are currently unlisted or removed from rebel.pl's public pages may not appear. The facets.availability map in each response reflects real-time stock status counts for the current result set.