Joueclub APIjoueclub.fr ↗
Access JouéClub product details, LEGO categories, brand listings, current promotions, and per-store pickup availability via the JouéClub API.
What is the Joueclub API?
The JouéClub API provides 5 endpoints covering the French toy retailer's catalog, including product details (EAN, price, availability, images), LEGO theme and age-group categories, the full brand list, live promotions, and per-store pickup status. The get_product_details endpoint returns 8 structured fields per product, while get_store_product_availability resolves in-store stock for any single store–product pair.
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'
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 and LEGO Catalog Data
The get_product_details endpoint accepts any JouéClub product page URL and returns the product's name, price in EUR, ean (13-digit barcode), lego_set_id extracted from the URL slug, availability using schema.org vocabulary (e.g. InStock), an array of images, and a description string. The get_lego_category_page endpoint requires no inputs and returns two arrays: themes (named LEGO product lines such as Star Wars and Technic, each with a title and url) and age_groups (spanning birth through 15+ years, also with title and url). Both are returned in a single, unpaginated response.
Brands and Promotions
get_brands_list returns the complete alphabetically sorted catalog of toy brands and licensed characters available on JouéClub. Each entry carries a name and a url pointing to that brand's dedicated page. get_promotions returns the currently active promotional items as an offers array of title–url pairs. The promotion list reflects the site's current campaign and changes as offers rotate, so results are time-sensitive.
Store-Level Pickup Availability
get_store_product_availability takes a product url and a store_id (numeric, matching the id field from a store record) and returns a detailed availability object. The response includes the store object (with id, code, name, and address_lines), has_store_stock boolean, pickup_datetime in ISO-8601 format, pickup_delay_text in French, store_price, web_price, and currency. The quantity field is always null because the source does not publish exact per-store stock counts. The endpoint is strictly read-only.
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?+
- Build a LEGO price-tracker by polling
get_product_detailswith set URLs and recording thepriceandavailabilityfields over time. - Index all JouéClub toy brands using
get_brands_listto create a filterable brand directory for a gift-finder app. - Feed current French toy promotions into a deal-alert bot using
get_promotionsto monitor the rotatingoffersarray. - Check whether a specific LEGO set is available for same-day pickup at a nearby store using
get_store_product_availabilitywith the product URL and store ID. - Classify LEGO products by age suitability by mapping
get_lego_category_pageage_groups onto product URLs. - Enrich an EAN-based product database with JouéClub pricing and images by passing product URLs to
get_product_details. - Compare
store_priceversusweb_pricefromget_store_product_availabilityto surface in-store vs. online price differences.
| 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 JouéClub have an official public developer API?+
What does `get_store_product_availability` actually return, and does it include exact stock quantities?+
has_store_stock (boolean), pickup_datetime (ISO-8601), pickup_delay_text in French, store_price, web_price, and store metadata. The quantity field is always null — the site does not publish exact per-store stock counts, so no numeric quantity is available through this endpoint.Is LEGO category data paginated, and how many categories are returned?+
get_lego_category_page returns all LEGO themes and all age groups in a single response. The number of entries reflects whatever is currently listed on JouéClub's LEGO boutique page and may change as JouéClub updates their catalog.Does the API cover product reviews or customer ratings for JouéClub items?+
Can I retrieve a list of JouéClub physical stores or their geographic coordinates?+
get_store_product_availability response, where the store object includes id, code, name, and address_lines for the queried store. A store locator endpoint returning all stores with coordinates is not currently included. You can fork this API on Parse and revise it to add a dedicated store-list endpoint.