Joueclub APIjoueclub.fr ↗
Access JouéClub product details, LEGO categories, brand listings, and current promotions via a structured JSON API. Covers prices, EAN codes, availability, and images.
What is the Joueclub API?
The JouéClub API gives developers structured access to France's JouéClub toy retailer catalog across 4 endpoints. Use get_product_details to retrieve a product's name, EUR price, EAN barcode, availability status, and images by passing a single product URL. The other endpoints cover LEGO theme and age-group categories, a full alphabetical brand directory, and active promotional offers — all returned as clean JSON without any scraping infrastructure on your end.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/fcfd484b-c2d0-4f1a-b657-5c1e35475801/get_lego_category_page' \ -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 joueclub-fr-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.
"""JouéClub toy catalog: browse LEGO categories, list brands, check promotions, fetch product details."""
from parse_apis.jouéclub_api import JoueClub, ProductNotFound
client = JoueClub()
# Get LEGO themes and age groups from the boutique page.
lego = client.legocategories.get()
print(f"LEGO themes: {len(lego.themes)}, age groups: {len(lego.age_groups)}")
for theme in lego.themes[:3]:
print(f" Theme: {theme.title} -> {theme.url}")
# List all available brands (capped for demo).
for brand in client.brands.list(limit=5):
print(f" Brand: {brand.name} -> {brand.url}")
# Check current promotional offers.
offer = client.offers.list(limit=1).first()
if offer:
print(f"Top promo: {offer.title} -> {offer.url}")
# Fetch full product details by URL; handle missing products.
try:
product = client.products.get(url="https://www.joueclub.fr/jeux-de-constructions-maquettes/lego-star-wars-75410-le-chasseur-n-1-de-mando-et-grogu-5702017817606.html")
print(f"Product: {product.name}, price={product.price}, availability={product.availability}")
except ProductNotFound as exc:
print(f"Product removed: {exc.url}")
print("Exercised: legocategories.get / brands.list / offers.list / products.get")
Retrieves LEGO themes and age group categories from the JouéClub LEGO boutique page. Themes include named LEGO product lines (Star Wars, Technic, etc.) and featured sets. Age groups span from birth through 15+ years. Returns all items in a single page; no pagination.
No input parameters required.
{
"type": "object",
"fields": {
"themes": "array of objects each with title (string) and url (string) for a LEGO theme or featured set",
"age_groups": "array of objects each with title (string) and url (string) for an age group category"
},
"sample": {
"data": {
"themes": [
{
"url": "https://www.joueclub.fr/contenu/lego-.html",
"title": "LEGO"
},
{
"url": "https://www.joueclub.fr/contenu/boutique-lego-star-wars.html",
"title": "LEGO Star Wars"
},
{
"url": "https://www.joueclub.fr/contenu/boutique-lego-technic.html",
"title": "LEGO Technic"
}
],
"age_groups": [
{
"url": "https://www.joueclub.fr/pour-les-menus/naissance.html",
"title": "Naissance"
},
{
"url": "https://www.joueclub.fr/pour-les-menus/3-ans.html",
"title": "3 ans"
},
{
"url": "https://www.joueclub.fr/pour-les-menus/6-ans.html",
"title": "6 ans"
}
]
},
"status": "success"
}
}About the Joueclub API
Product Data
The get_product_details endpoint accepts a full JouéClub product page URL and returns a consistent set of fields: name, price (in EUR), ean (13-digit barcode), lego_set_id (where applicable), availability (e.g. InStock), description, images (array of URLs), and the canonical url. This makes it straightforward to sync JouéClub listings against a product database keyed on EAN or LEGO set number.
LEGO Categories and Brands
get_lego_category_page returns two arrays from the JouéClub LEGO boutique page: themes (e.g. Star Wars, Technic, City) and age_groups, each entry carrying a title and url. These URLs can be fed back into other tooling to enumerate products within a category. get_brands_list returns the full brands array — names and page URLs — for all toy brands and licensed characters stocked on the site, sorted alphabetically.
Promotions
get_promotions returns an offers array where each entry has a title and url pointing to the relevant product page. This endpoint reflects whatever promotions JouéClub is currently running, making it useful for deal-monitoring workflows or price-drop alerting when combined with get_product_details.
Coverage Notes
All endpoints target the French-language JouéClub catalog (joueclub.fr). Product pricing is in EUR. The availability field on get_product_details reflects stock status as reported on the product page. No login or account credentials are required to use any endpoint.
The Joueclub API is a managed, monitored endpoint for joueclub.fr — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when joueclub.fr 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 joueclub.fr 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 JouéClub promotional offers and alert users when specific LEGO sets appear in the
offersarray. - Build a LEGO set price tracker by polling
get_product_detailswith known product URLs and comparing thepricefield over time. - Enrich a toy product database by cross-referencing the
eanfield returned byget_product_detailswith other retail sources. - Catalog all stocked toy brands on JouéClub using
get_brands_listfor competitive brand coverage analysis. - Map LEGO themes and age-group categories from
get_lego_category_pageto build a structured navigation layer for a comparison site. - Track
availabilitychanges on specific LEGO sets to detect restock events on the French market. - Aggregate current JouéClub promotions alongside other French toy retailers for a deal-aggregation feed.
| 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 JouéClub offer an official developer API?+
What does `get_product_details` return beyond the price?+
name, price (EUR), ean (13-digit barcode), lego_set_id (when the product is a LEGO set), availability (e.g. InStock), description, images (array of image URLs), and the canonical url. The input is a single full product page URL.Does the API cover customer reviews or ratings for products?+
Can I retrieve all products within a specific LEGO theme or brand category?+
get_lego_category_page and get_brands_list return the category and brand URLs, but fetching all products within those pages is not covered. You can fork the API on Parse and revise it to add a product-listing endpoint that accepts those category URLs.How current is the promotions data from `get_promotions`?+
get_promotions endpoint reflects whatever offers are displayed on the JouéClub promotions page at the time of the request. It returns title and url for each offer; to get the current price or stock status of a promoted item, call get_product_details with the returned URL.