# Aramisauto Search API Documentation

Search the live Aramisauto catalogue in France. Filter by free text, make and model slug, energy and mileage range, and sort by price, mileage, registration date or discount. Paginate with page and limit; total is the filtered number of matching cars and has_more comes from the same response. Reserved cars appear with availability Réservé. page times limit must not exceed 10000. A search with no match returns an empty vehicles array, which is a successful, billable response. Prices are in EUR, mileage in km.

- **Documentation:** [https://scrappa.co/docs/aramisauto-api/aramisauto_search](https://scrappa.co/docs/aramisauto-api/aramisauto_search)
- **API group:** Aramisauto API
- **Endpoint:** `GET https://scrappa.co/api/aramisauto/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 |
| --- | --- | --- | --- |
| `query` | string | No | Free text, for example clio. |
| `energy` | string | No | One of electric, gasoline, diesel, full-hybrid-gasoline, full-hybrid-diesel, plugin-hybrid-gasoline, plugin-hybrid-diesel, mild-hybrid-gasoline, mild-hybrid-diesel, mild-hybrid-gasoline-lpg, ethanol-e85, hydrogen, liquefied-petroleum-gas, compressed-natural-gas. |
| `make` | string | No | Make slug, for example peugeot. |
| `model` | string | No | Model slug, for example 208. Needs make. |
| `mileage_min` | integer | No | Minimum mileage in km. |
| `mileage_max` | integer | No | Maximum mileage in km. |
| `sort` | string | No | default, price_asc, price_desc, mileage_asc, mileage_desc, newest_registration, newest_listing or discount_desc. Defaults to default. |
| `page` | integer | No | 1-based page number. Defaults to 1. |
| `limit` | integer | No | Items per page, 1 to 48. Defaults to 24. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/aramisauto/search?query=clio&limit=2"
```

## Example response

```json
{
    "success": true,
    "data": {
        "vehicles": [
            {
                "position": 1,
                "id": "1026548",
                "offer_id": "rv1026548",
                "url": "https://www.aramisauto.com/voitures/renault/clio/business/rv1026548?vehicleId=1026548",
                "offer_type": "Occasion",
                "availability": "Disponible",
                "make": "Renault",
                "model": "CLIO",
                "model_iteration": "Clio 5",
                "engine": "Clio TCe 90 - 21",
                "trim": "Business",
                "energy": "Essence",
                "transmission": "Manuelle",
                "body": "Citadine",
                "color": "Blanc",
                "first_registration_date": "2021-06-04",
                "price_eur": 14399,
                "catalog_price_eur": 20000,
                "mileage_km": 25408,
                "power_hp": 90,
                "thumbnail_url": "https://storage.googleapis.com/aramis_mp_prod/pictures/1026548/54068203_20260916101050.jpg"
            }
        ],
        "total": 86,
        "page": 1,
        "limit": 2,
        "has_more": true
    },
    "meta": {
        "endpoint_family": "search",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | The requested vehicle was not found or is no longer listed. This response is not billable. |
| 422 | Validation Error | A parameter is invalid, including an unknown energy or sort, or page times limit above 10000. This response is not billable. |
| 503 | Service Unavailable | The service could not obtain a complete result from Aramisauto. 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)