joueclub.fr 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.
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'
Get list of LEGO themes and age group categories with their links from the JouéClub LEGO boutique page.
No input parameters required.
{
"type": "object",
"fields": {
"themes": "array of objects with title and url for each LEGO theme",
"age_groups": "array of objects with title and url for each age group category"
},
"sample": {
"data": {
"themes": [
{
"url": "https://www.joueclub.fr/contenu/boutique-lego-star-wars.html",
"title": "LEGO Star Wars"
}
],
"age_groups": [
{
"url": "https://www.joueclub.fr/jouets-1er-age/les-cadeaux-de-naissance.html",
"title": "Les cadeaux de naissance"
}
]
},
"status": "success"
}
}About the joueclub.fr 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.
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.
- 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 | 250 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.