View all API endpoints

Leboncoin Search

Enables users to search for ads on Leboncoin, the leading classified ads platform in France.
Leboncoin
August 12, 2023
2847
ms
287
k requests
14
votes
▶ Try for free
Get it customized
No credit card required

Request:

  • query: A valid Leboncoin Search URL.

Response:

  • Total count of ads.
  • Breakdown of ads (pro, private, active, etc.).
  • List of ads with details (price, images, location, etc.).
Content:

Header

x-api-key required

string

Parameter defines the Piloterr private key to use.

Parameters

query

string

A Leboncoin Search URL

GET
POST
/api/v2/leboncoin/search
Example Request
curl --location --request GET 'https://piloterr.com/api/v2/leboncoin/search?query=https://www.leboncoin.fr/recherche?category=9%26locations=Paris__48.8495376581948_2.340572835508209_8691' \
--header 'Content-Type: application/json' \
--header 'x-api-key: <token>' \
Response
{ "total": 8830, "total_all": 8830, "total_pro": 7060, "total_private": 1770, "total_active": 0, "total_inactive": 0, "total_shippable": 0, "max_pages": 100, "ads": [ { "ad_type": "offer", "attributes": [ { "key": "rating_score", "value": "1", "values": [ "1" ], "value_label": "1", "generic": false }, { "key": "rating_count", "value": "19", "values": [ "19" ], "value_label": "19", "generic": false }, { "key": "profile_picture_url", "value": "https://img.leboncoin.fr/api/v1/tenants/9a6387a1-6259-4f2c-a887-7e67f23dd4cb/domains/20bda58f-d650-462e-a72a-a5a7ecf2bf88/buckets/21d2b0bc-e54c-4b64-a30b-89127b18b785/images/profile/pictures/default/7c703017-600b-5ae7-972d-40c545219c7b?rule=pp-small", "values": [ "https://img.leboncoin.fr/api/v1/tenants/9a6387a1-6259-4f2c-a887-7e67f23dd4cb/domains/20bda58f-d650-462e-a72a-a5a7ecf2bf88/buckets/21d2b0bc-e54c-4b64-a30b-89127b18b785/images/profile/pictures/default/7c703017-600b-5ae7-972d-40c545219c7b?rule=pp-small" ], "value_label": "https://img.leboncoin.fr/api/v1/tenants/9a6387a1-6259-4f2c-a887-7e67f23dd4cb/domains/20bda58f-d650-462e-a72a-a5a7ecf2bf88/buckets/21d2b0bc-e54c-4b64-a30b-89127b18b785/images/profile/pictures/default/7c703017-600b-5ae7-972d-40c545219c7b?rule=pp-small", "generic": false }, { "key": "real_estate_type", "value": "4", "values": [ "4" ], "key_label": "Type de bien", "value_label": "Parking", "generic": true }, { "key": "square", "value": "15", "values": [ "15" ], "key_label": "Surface", "value_label": "15 m²", "generic": true }, { "key": "rooms", "value": "1", "values": [ "1" ], "key_label": "Pièces", "value_label": "1", "generic": true }, { "key": "energy_rate", "value": "a", "values": [ "a" ], "key_label": "Classe énergie", "value_label": "A", "generic": true }, { "key": "ges", "value": "a", "values": [ "a" ], "key_label": "GES", "value_label": "A", "generic": true }, { "key": "nb_parkings", "value": "1", "values": [ "1" ], "key_label": "Places de parking", "value_label": "1", "generic": true }, { "key": "district_id", "value": "75109", "values": [ "75109" ], "value_label": "75109", "generic": false }, { "key": "district_visibility", "value": "false", "values": [ "false" ], "value_label": "false", "generic": false }, { "key": "district_type_id", "value": "3", "values": [ "3" ], "value_label": "3", "generic": false }, { "key": "district_resolution_type", "value": "integration", "values": [ "integration" ], "value_label": "integration", "generic": false }, { "key": "immo_sell_type", "value": "old", "values": [ "old" ], "value_label": "old", "generic": false }, { "key": "is_import", "value": "false", "values": [ "false" ], "value_label": "false", "generic": false }, { "key": "lease_type", "value": "sell", "values": [ "sell" ], "value_label": "sell", "generic": false }, { "key": "old_price", "value": "31000", "values": [ "31000" ], "value_label": "31000", "generic": false } ], "body": "", "category_id": "9", "category_name": "Ventes immobilières", "first_publication_date": "2023-04-20 21:48:31", "has_phone": false, "images": { "thumb_url": "https://img.leboncoin.fr/api/v1/lbcpb1/images/7f/1a/5a/7f1a5a785496c2a9344d325b48c0bfc0a067dc8b.jpg?rule=ad-thumb", "small_url": "https://img.leboncoin.fr/api/v1/lbcpb1/images/7f/1a/5a/7f1a5a785496c2a9344d325b48c0bfc0a067dc8b.jpg?rule=ad-small", "nb_images": 1, "urls": [ "https://img.leboncoin.fr/api/v1/lbcpb1/images/7f/1a/5a/7f1a5a785496c2a9344d325b48c0bfc0a067dc8b.jpg?rule=ad-image" ], "urls_thumb": [ "https://img.leboncoin.fr/api/v1/lbcpb1/images/7f/1a/5a/7f1a5a785496c2a9344d325b48c0bfc0a067dc8b.jpg?rule=ad-thumb" ], "urls_large": [ "https://img.leboncoin.fr/api/v1/lbcpb1/images/7f/1a/5a/7f1a5a785496c2a9344d325b48c0bfc0a067dc8b.jpg?rule=ad-large" ] }, "index_date": "2023-04-20 21:48:31", "list_id": 2179560719, "location": { "country_id": "FR", "region_id": "12", "region_name": "Ile-de-France", "department_id": "75", "department_name": "Paris", "city_label": "Paris 75009 9e Arrondissement", "city": "Paris", "zipcode": "75009", "lat": 48.87115, "lng": 2.33207, "source": "city", "provider": "here", "is_shape": true, "feature": { "type": "Feature", "geometry": { "type": "Point", "coordinates": [ 2.33207, 48.87115 ] }, "properties": null } }, "options": { "has_option": false, "booster": false, "photosup": false, "urgent": false, "gallery": false, "sub_toplist": false }, "owner": { "store_id": "14589713", "user_id": "1988e0d2-9857-4270-80a3-16bee1703849", "type": "private", "name": "Dan", "no_salesmen": true, "activity_sector": "" }, "price": [ 30500 ], "price_cents": 3050000, "price_calendar": null, "status": "active", "subject": "Parking Galeries Lafayette", "url": "https://www.leboncoin.fr/ventes_immobilieres/2179560719.htm" }, ... ]
}
Sign up now and enjoy 100 free API requests + full access to our premium features and tools.
Other API endpoints that might be of interest for you:

Take a look at our blog posts

Interviews, tips, guides, industry best practices and news.
What is Residential Proxy ?
Proxy
10
min read

What is Residential Proxy ?

A residential proxy is a type of proxy server that routes internet traffic via an intermediary...
Read post
Web Scraping for Lead Generation
Scraping
8
min read

Web Scraping for Lead Generation

Gathering contact information from websites in order to generate leads for businesses is known...
Read post
Free Proxies for Web Scraping
Proxy
9
min read

Free Proxies for Web Scraping

Free Proxies are the web servers that act as intermediaries between computers and the internet...
Read post
By clicking “Accept”, you agree to the storing of cookies to enhance site navigation and analyze site usage. View our Privacy Policy for more information.