Leboncoin Locations Search — Place Name to Location, Postcode & Coordinates
Send a place name or postcode, such as Bordeaux, and this source returns the matching Leboncoin location objects: label, city, postcode, department ID, region ID and coordinates.
{
"session_id": "11111111-1111-1111-1111-111111111111",
"kind": "leboncoin_locations_search",
"keyword": "Bordeaux",
"max_items": 2,
"start_page": 1,
"human": "# leboncoin locations search\n\n- **Search term:** Bordeaux\n- **Max items:** 2\n- **Starting page:** 1\n- **Records returned:** 1\n- **Proxy traffic:** 7.6 KB",
"machine": {
"total_items": 1,
"items": [
{
"@type": "LeboncoinLocation",
"location_type": "city",
"label": "Bordeaux (33000)",
"city": "Bordeaux",
"district": null,
"zipcode": "33000",
"department_id": "33",
"region_id": "2",
"lat": 44.8367,
"lng": -0.58105,
"radius": null
}
],
"response_bytes": 7750
},
"total_points": 1
}- You send
- A French place name or postcode
- You get back
- Matching locations with label, city, postcode, department and region ID, and coordinates
- Coverage
- French places known to Leboncoin's location lookup.
- Price
- 1 point per returned result, up to 50 per request — $1 per 1,000
- Billed per location actually returned, capped by max_items. A keyword that matches nothing costs nothing.
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 | Type the place into the site's location box and read the suggestions | Free, and manual | Fine for a few places |
| 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 per place name | $1 per 1,000, misses not billed | Returns what the site's location lookup returns, which can include more than one match |
What you get back
Every field in the response shown above.
| Field | Type | Description |
|---|---|---|
total_items | number | How many locations were returned. |
items | array | The matching locations. |
@type | string | Record type, LeboncoinLocation. |
location_type | string | Kind of location, e.g. city. |
label | string | Display label, e.g. a city with its postcode. |
city | string | City name. |
district | string | District, when the match is one. Null otherwise. |
zipcode | string | Postcode. |
department_id | string | Department ID. |
region_id | string | Region ID. |
lat | number | Latitude. |
lng | number | Longitude. |
radius | number | Search radius attached to the location, when present. Null otherwise. |
How to run it
The same lookup works from the app, the API, or as a tool an agent can call mid-task.
max_items defaults to 25 and goes up to 50. A name can match several places; check location_type and zipcode before picking one.
curl -X POST https://api.neuralverge.ai/functions/v1/run-leboncoin-locations-search \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "keyword": "Bordeaux", "max_items": 2 }'What teams use it for
Where this field shows up in an actual workflow.
Turn free-text place names from your data into consistent location records.
Get coordinates, postcode, department and region for a French town.
Group Leboncoin ads and sellers by department or region ID.
Coverage, freshness and limits
What this source covers, how fresh it is, and where it stops.
French places known to Leboncoin's location lookup.
Read at request time.
This source returns publicly visible location information, stamped with the search term and a session id you can trace.
- —Only places that Leboncoin's own location lookup knows are returned.
- —Department and region come back as IDs, not names.
- —An ambiguous name can return several matches.
Questions, answered
Yes. The keyword accepts a place name or a postcode.
Related sources
The Leboncoin category tree with IDs, slugs, parents and subcategories, plus an optional search-filter catalogue.
Browse Leboncoin's professional-stores directory by activity sector: ID, name, sector, city, department and region.
A full Leboncoin ad by ID or URL: price, category attributes, images, location, dates and seller.
Amazon, eBay, Walmart, AliExpress and Alibaba product, seller and review data.
Try leboncoin locations search on your own data
One request format across every source in the catalog.