# Getaround Search API Documentation

Search Getaround cars by latitude and longitude or by address, plus start and end dates and an optional price floor. Returns price per day as a number with its currency, rating, rating count, make, model, year and full-size image URLs. Cars carry an id and a path that the detail endpoint accepts unchanged. Paginate with page; next_page tells whether more pages exist. Only filters proven to change results are exposed, so no returned car violates a requested filter.

- **Documentation:** [https://scrappa.co/docs/getaround-api/getaround_search](https://scrappa.co/docs/getaround-api/getaround_search)
- **API group:** Getaround API
- **Endpoint:** `GET https://scrappa.co/api/getaround/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 |
| --- | --- | --- | --- |
| `domain` | string | No | Site variant: fr, es, no or be. Defaults to fr. |
| `latitude` | number | No | Pick-up latitude, for example 48.8566. Use with longitude or use address instead. |
| `longitude` | number | No | Pick-up longitude, for example 2.3522. Use with latitude or use address instead. |
| `address` | string | No | Human-readable pick-up location, for example Paris. Use with poi_id instead of latitude and longitude. |
| `poi_id` | string | No | Optional point of interest id that pairs with address. |
| `start_date` | string | Yes | Rental start date in YYYY-MM-DD. |
| `end_date` | string | Yes | Rental end date in YYYY-MM-DD, on or after start_date. |
| `start_time` | string | No | Optional pick-up time in HH:MM. |
| `end_time` | string | No | Optional return time in HH:MM. |
| `price_min` | number | No | Minimum price per day in the site currency. |
| `page` | integer | No | 1-based page number, 1 to 25. Defaults to 1. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/getaround/search?latitude=48.8566&longitude=2.3522&start_date=2026-12-01&end_date=2026-12-05&page=1"
```

## Example response

```json
{
    "success": true,
    "data": {
        "search_metadata": {
            "domain": "fr",
            "page": 1,
            "result_count": 40,
            "total_count": 1001,
            "next_page": 2,
            "has_more": true
        },
        "filters": [],
        "cars": [
            {
                "id": "1323651",
                "title": "Renault Twingo",
                "make": "Renault",
                "model": "Twingo",
                "year": 2019,
                "price": 35.5,
                "original_price": 39,
                "currency": "EUR",
                "rating": 4.58,
                "rating_count": 82,
                "instant_bookable": true,
                "image_url": "https://drivy.gumlet.io/cars/1323651/main.jpg",
                "path": "/location-voiture/paris/renault-twingo-1323651",
                "url": "https://fr.getaround.com/location-voiture/paris/renault-twingo-1323651",
                "location": {
                    "latitude": 48.8566,
                    "longitude": 2.3522
                }
            }
        ]
    },
    "meta": {
        "endpoint_family": "search",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | The requested Getaround car is not listed any more. 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 from Getaround. 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)
