> ## Documentation Index > Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt > Use this file to discover all available pages before exploring further. # Search Ads > Search Leboncoin classified ads across France with location, price, and seller filters. ## Query Parameters Search keywords. Matches against ad titles and descriptions. Restrict results to a Leboncoin category id. Use [`/v1/leboncoin/categories`](/api-reference/endpoint/leboncoin/list-categories) to look up ids. Restrict results to a French region (includes DOM-TOM overseas territories). Use [`/v1/leboncoin/regions`](/api-reference/endpoint/leboncoin/list-regions) to look up ids. Restrict results to a French department. Use [`/v1/leboncoin/departments`](/api-reference/endpoint/leboncoin/list-departments) to look up ids. Restrict results to a city name. Resolve names with [`/v1/leboncoin/locations/search`](/api-reference/endpoint/leboncoin/search-locations). Restrict results to a French postal code. Minimum price filter in euros. Maximum price filter in euros. Filter by seller type. | Value | Description | | --------- | ------------------------- | | `all` | All sellers (default) | | `pro` | Professional sellers only | | `private` | Private individuals only | Filter by ad type. | Value | Description | | -------- | -------------------------------- | | `offer` | Items offered for sale (default) | | `demand` | Wanted / demand ads | Sort order for results. | Value | Description | | ------------ | ----------------------------- | | `relevance` | Best match (default) | | `newest` | Most recently published first | | `oldest` | Oldest first | | `price_low` | Cheapest first | | `price_high` | Most expensive first | Page number for paginated results. Results per page. Maximum `100`. ## Response Array of matching ads. Leboncoin ad id (integer). Ad title. Ad description text. Brand name, if detected (nullable). `offer` or `demand`. Full URL to the ad. Ad status (e.g. `active`). Leboncoin category id. Human-readable category name. Price in euros as an array (Leboncoin returns price as a list of integers). Price in cents (nullable). Price in euros as a number (nullable). Currency code. Always `EUR`. Raw first-publication date as shown on Leboncoin. ISO 8601 first-publication timestamp. Raw index (last-bumped) date. ISO 8601 index timestamp. Raw expiration date (nullable). ISO 8601 expiration timestamp (nullable). Whether the seller published a phone number. Number of times the ad was favorited (nullable). Image set for the ad. Total number of images. Standard-resolution image URLs. Thumbnail image URLs. Large / full-resolution image URLs. Category-specific attributes. Attribute machine key (e.g. `brand`). Human-readable attribute label (e.g. `Marque`). Attribute machine value. Human-readable attribute value. List of values for multi-value attributes (nullable). Whether the attribute is generic (shared across categories). Geographic location of the ad. Country id. Always `FR`. French region id (nullable). Region name (nullable). Department id (nullable). Department name (nullable). City machine name (nullable). City display name (nullable). Postal code (nullable). District / neighbourhood (nullable). Latitude (nullable). Longitude (nullable). Whether the location is an approximate shape rather than an exact point. Ad owner summary. Seller UUID. Store id, for pro sellers with a storefront (nullable). `private` or `pro`. Seller display name. SIREN company registration number, for pro sellers (nullable). Whether the seller opted out of solicitation. Number of ads matching the current filters. Total ads matching the query across all seller types. Total matching ads from professional sellers. Total matching ads from private sellers. Total matching ads eligible for shipping. Maximum number of pages available for this query. The page that was returned. The page size that was applied. The upstream source the results were scraped from. ### Example Response ```json theme={null} { "ads": [ { "list_id": 2845123456, "subject": "Vélo électrique VTC 500W - Excellent état", "body": "Vélo électrique acheté il y a 6 mois, très peu servi. Batterie 48V.", "brand": "Moustache", "ad_type": "offer", "url": "https://www.leboncoin.fr/velos/2845123456.htm", "status": "active", "category_id": "24", "category_name": "Vélos", "price": [890], "price_cents": 89000, "price_eur": 890.0, "currency": "EUR", "first_publication_date": "2026-06-18 09:42:11", "first_publication_at": "2026-06-18T09:42:11Z", "index_date": "2026-06-20 14:10:03", "index_at": "2026-06-20T14:10:03Z", "expiration_date": "2026-08-17 09:42:11", "expiration_at": "2026-08-17T09:42:11Z", "has_phone": true, "favorites": 12, "images": { "nb_images": 3, "urls": ["https://img.leboncoin.fr/api/v1/lbcpb1/images/ab/cd/abcd.jpg"], "urls_thumb": ["https://img.leboncoin.fr/api/v1/lbcpb1/images/ab/cd/abcd_thumb.jpg"], "urls_large": ["https://img.leboncoin.fr/api/v1/lbcpb1/images/ab/cd/abcd_large.jpg"] }, "attributes": [ { "key": "brand", "key_label": "Marque", "value": "moustache", "value_label": "Moustache", "generic": true } ], "location": { "country_id": "FR", "region_id": "22", "region_name": "Île-de-France", "department_id": "75", "department_name": "Paris", "city": "paris", "city_label": "Paris 11e", "zipcode": "75011", "lat": 48.8594, "lng": 2.3765, "is_shape": false }, "owner": { "user_id": "b3f1c2a0-8d4e-4a1b-9c2d-1e2f3a4b5c6d", "type": "private", "name": "Julien", "no_salesmen": true } } ], "total": 1284, "total_all": 1284, "total_pro": 312, "total_private": 972, "total_shippable": 540, "max_pages": 37, "page": 1, "limit": 35, "source": "leboncoin.fr" } ``` Each search request costs **5 credits**. Failed requests are not charged.