# mobile.de Search API Documentation

Search current vehicle listings with validated filters, sorting, and offset pagination. Totals and adjacent pages are live snapshots. Optional facets and offer cards never prevent core search results from being returned.

- **Documentation:** [https://scrappa.co/docs/mobile-de-api/mobile_de_search](https://scrappa.co/docs/mobile-de-api/mobile_de_search)
- **API group:** mobile.de API
- **Endpoint:** `GET https://scrappa.co/api/mobile-de/v1/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 |
| --- | --- | --- | --- |
| `vehicle_type` | string | No | Vehicle type. v1 supports car. |
| `query` | string | No | Optional free-text vehicle search. |
| `offset` | integer | No | Zero-based result offset. Defaults to 0. |
| `limit` | integer | No | Listings to return, from 1 to 20. |
| `price_min` | integer | No | Optional non-negative minimum price. |
| `price_max` | integer | No | Optional non-negative maximum price. |
| `registration_year_min` | integer | No | Optional minimum first-registration year. |
| `registration_year_max` | integer | No | Optional maximum first-registration year. |
| `mileage_min` | integer | No | Optional non-negative minimum mileage. |
| `mileage_max` | integer | No | Optional non-negative maximum mileage. |
| `fuel` | array | No | Repeatable proved fuel value. Initially PETROL. |
| `transmission` | array | No | Repeatable proved transmission value. Initially AUTOMATIC_GEAR. |
| `price_rating` | array | No | VERY_GOOD_PRICE and/or GOOD_PRICE. |
| `make_id` | string | No | Validated marketplace make identifier. |
| `model_id` | string | No | Validated marketplace model identifier. Requires make_id. |
| `sort` | string | No | relevance, price_asc, or price_desc. |
| `include` | array | No | Optional facets and/or offer_cards enrichment. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/mobile-de/v1/search?query=Golf&offset=0&limit=20&sort=price_asc"
```

## Example response

```json
{
    "success": true,
    "data": {
        "listings": [],
        "pagination": {
            "offset": 0,
            "limit": 20,
            "next_offset": null,
            "total": 0,
            "live_snapshot": true
        }
    },
    "meta": {
        "endpoint_family": "search"
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Listing Not Found | The requested listing is no longer available. This response is not billable. |
| 422 | Validation Error | A public parameter or range is invalid. This response is not billable. |
| 502 | Invalid Source Response | The marketplace returned an invalid response. 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)