# Leboncoin Autos Search

Search car listings across the French market. Every listing comes back with its full description, price, location, images, seller identity and structured vehicle attributes such as brand, model, mileage, fuel, gearbox and price evaluation. Read-only public listing data; no Leboncoin account required.

- **Documentation:** [https://scrappa.co/docs/leboncoin-autos-api/leboncoin_autos_search](https://scrappa.co/docs/leboncoin-autos-api/leboncoin_autos_search)
- **API group:** Leboncoin Autos API
- **Endpoint:** `GET https://scrappa.co/api/leboncoin-autos/search`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `brand` | array | No | Filter by car brand. Repeatable, e.g. brand[]=Opel. |
| `model` | array | No | Filter by car model. Repeatable, e.g. model[]=Astra. |
| `fuel` | array | No | 1 Essence, 2 Diesel, 3 GPL, 4 Electrique, 5 Autre, 6 Hybride. Repeatable. |
| `gearbox` | array | No | 1 Manuelle, 2 Automatique. Repeatable. |
| `vehicle_type` | array | No | Body type: citadine, berline, break, suv, coupe, cabriolet, monospace, utilitaire, autre. |
| `price_min` | integer | No | Minimum price in euros. |
| `price_max` | integer | No | Maximum price in euros. |
| `mileage_min` | integer | No | Minimum mileage in kilometres. |
| `mileage_max` | integer | No | Maximum mileage in kilometres. |
| `regdate_min` | integer | No | Minimum first registration year. |
| `regdate_max` | integer | No | Maximum first registration year. |
| `keywords` | string | No | Free-text search term. |
| `location` | object | No | Object with city, zipcode, department_id, region_id. |
| `owner_type` | string | No | all, pro for professionals, or private. |
| `sort_by` | string | No | relevance, time, price or proximity. |
| `sort_order` | string | No | asc or desc. |
| `page` | integer | No | 1-based page number. |
| `limit` | integer | No | Listings per page, 1-100. Default 35. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/leboncoin-autos/search?brand%5B0%5D=Opel&model%5B0%5D=Astra&fuel%5B0%5D=2&gearbox%5B0%5D=1&price_min=5000&price_max=20000&regdate_min=2015&limit=3"
```

## Example response

```json
{
    "success": true,
    "data": {
        "ads": [
            {
                "list_id": 3232642751,
                "subject": "Opel astra",
                "price": 5000,
                "price_cents": 500000,
                "currency": "EUR",
                "url": "https://www.leboncoin.fr/voitures/3232642751.htm",
                "location": {
                    "city": "Paris",
                    "zipcode": "75001"
                },
                "owner": {
                    "type": "pro",
                    "store_id": 82576925,
                    "siren": "980715981"
                },
                "attributes": {
                    "brand": "Opel",
                    "model": "Astra",
                    "regdate": 2016,
                    "mileage": 216000,
                    "fuel": "Diesel",
                    "gearbox": "Manuelle",
                    "car_price_min": 5030,
                    "car_price_max": 5560,
                    "car_price_positioning": "Bonne affaire"
                },
                "images": {
                    "nb_images": 5,
                    "urls": [
                        "https://img.leboncoin.fr/api/v1/lbcpb1/images/abc.jpg"
                    ]
                }
            }
        ],
        "total": 341,
        "total_pro": 236,
        "max_pages": 114,
        "page": 1,
        "limit": 3,
        "has_more": true
    },
    "meta": {
        "endpoint_family": "search",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | The requested car listing was not found. This response is not billable. |
| 422 | Validation Error | A public parameter is invalid. This response is not billable. |
| 503 | Service Unavailable | The service could not obtain a complete result. This response is not billable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)