Leboncoin Category Tree — Category IDs, Slugs & Subcategories
Send an empty request and get back the Leboncoin category tree: every category with its ID, name, slug and parent, with subcategories nested inside. Pass a category ID or slug, such as 2 or voitures, to narrow the result.
{
"session_id": "11111111-1111-1111-1111-111111111111",
"kind": "leboncoin_categories",
"category": null,
"include_filters": false,
"human": "# leboncoin categories\n\n- **Category:** (all)\n- **Include filters:** no\n- **Categories returned:** 115\n- **Proxy traffic:** 667.4 KB",
"machine": {
"total_items": 115,
"items": [
{
"@type": "LeboncoinCategory",
"id": "0",
"name": "Toutes catégories",
"slug": "toutes_categories",
"parent_id": null,
"subcategories": [
{
"@type": "LeboncoinCategory",
"id": "8",
"name": "Immobilier",
"slug": "_immobilier_",
"parent_id": "0",
"subcategories": [
{
"@type": "LeboncoinCategory",
"id": "9",
"name": "Ventes immobilières",
"slug": "ventes_immobilieres",
"parent_id": "8",
"subcategories": [],
"filters": []
},
{
"@type": "LeboncoinCategory",
"id": "2001",
"name": "Immobilier Neuf",
"slug": "immobilier_neuf",
"parent_id": "8",
"subcategories": [],
"filters": []
}
],
"filters": []
},
{
"@type": "LeboncoinCategory",
"id": "1",
"name": "Véhicules",
"slug": "_vehicules_",
"parent_id": "0",
"subcategories": [
{
"@type": "LeboncoinCategory",
"id": "2",
"name": "Voitures",
"slug": "voitures",
"parent_id": "1",
"subcategories": [],
"filters": []
},
{
"@type": "LeboncoinCategory",
"id": "3",
"name": "Motos",
"slug": "motos",
"parent_id": "1",
"subcategories": [],
"filters": []
}
],
"filters": []
}
],
"filters": []
}
],
"response_bytes": 683441
},
"total_points": 5
}- You send
- Nothing, or an optional category ID or slug, and an optional include_filters flag
- You get back
- Categories with ID, name, slug, parent and nested subcategories
- Coverage
- The Leboncoin category tree.
- Price
- 5 points per run, flat — $5 per 1,000 runs
- Flat price per successful run; the sample response below shows 115 categories billed at 5 points in total.
Ways to get this data
Three approaches teams use today, and where each one runs into trouble.
| Approach | What it takes | Cost | Trade-off |
|---|---|---|---|
| Checking it by hand | Click through the site's categories and read the URLs | Free, and tedious | Fine for one category, impractical for the full tree |
| Building a scraper | Write it, host it, and repair it when the site changes | Engineering time | A maintenance commitment for something that isn't your product |
| NeuralVerge | One request, optional category and filters flag | $5 flat per run | Returns the whole tree unless you pass a category |
What you get back
Every field in the response shown above.
| Field | Type | Description |
|---|---|---|
total_items | number | How many categories are in the response. |
items | array | The categories, with subcategories nested inside. |
@type | string | Record type, LeboncoinCategory. |
id | string | Leboncoin category ID. |
name | string | Category name, in French. |
slug | string | URL slug for the category. |
parent_id | string | ID of the parent category; null at the top. |
subcategories | array | Child categories, in the same shape. |
filters | array | Search filters for the category. Populated only when include_filters is true, on the first category. |
How to run it
The same lookup works from the app, the API, or as a tool an agent can call mid-task.
Both parameters are optional. Pass category as an ID or slug to narrow the tree; set include_filters to true to get the filter catalogue on the first category. Cache the result; the tree changes rarely.
curl -X POST https://api.neuralverge.ai/functions/v1/run-leboncoin-categories \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'What teams use it for
Where this field shows up in an actual workflow.
Find the category ID or slug for the part of the market you're studying.
Use include_filters to learn which search filters a category supports.
Match Leboncoin categories to your own product taxonomy.
Coverage, freshness and limits
What this source covers, how fresh it is, and where it stops.
The Leboncoin category tree.
Read at request time.
This source returns publicly visible category information, stamped with a session id you can trace.
- —The tree reflects the site's current categories; they can be renamed or retired later.
- —Names are in French, as the site publishes them.
- —Filters are populated only when include_filters is true, and only on the first category.
Questions, answered
No. Both category and include_filters are optional. An empty request returns the whole tree.
Related sources
A full Leboncoin ad by ID or URL: price, category attributes, images, location, dates and seller.
Resolve a French place name or postcode into Leboncoin location objects with coordinates.
Browse Leboncoin's professional-stores directory by activity sector: ID, name, sector, city, department and region.
Amazon, eBay, Walmart, AliExpress and Alibaba product, seller and review data.
Try leboncoin categories on your own data
One request format across every source in the catalog.