# derStandard Immobilien Location Autocomplete API Documentation

Scrappa's `GET /api/derstandard-immobilien/autocomplete` finds Austrian locations by the start of a name or a postal code.

## What you get

Each location has `slug` (use it as `location` in search), `osm_id` (use it in `osm_ids`), `name`, `full_name`, `level` (state, county, city and so on), `parent` and the postal codes. A term without matches returns `200` with an empty list.

- **Documentation:** [https://scrappa.co/docs/derstandard-immobilien-api/derstandard_immobilien_autocomplete](https://scrappa.co/docs/derstandard-immobilien-api/derstandard_immobilien_autocomplete)
- **API group:** derStandard Immobilien API
- **Endpoint:** `GET https://scrappa.co/api/derstandard-immobilien/autocomplete`

## 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 |
| --- | --- | --- | --- |
| `q` | string | Yes | Start of a place name or postal code, at least 2 characters. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/derstandard-immobilien/autocomplete?q=Graz"
```

## Example response

```json
{
    "success": true,
    "query": "Graz",
    "returned": 1,
    "locations": [
        {
            "slug": "bezirk-graz-umgebung",
            "osm_id": 34676,
            "name": "Graz-Umgebung",
            "full_name": "Bezirk Graz-Umgebung",
            "level": "county",
            "parent": {
                "osm_id": 35183,
                "name": "Steiermark",
                "level": "state"
            },
            "postal_code": null,
            "postal_codes": []
        }
    ],
    "meta": {
        "endpoint_family": "autocomplete",
        "billable": true,
        "attempts": 1,
        "duration_ms": 310
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing, unknown or unusable. Unknown parameters are rejected, never ignored. Non-billable. |
| 503 | Upstream Unavailable | derStandard Immobilien could not be reached or answered with an error (`upstream_unavailable`). When no outbound connection is available nothing is sent and `meta.attempts` is 0. Retryable and never billed. Clients are never rate limited. |

## 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)