# ImmobilienScout24 Austria Similar Listings API Documentation

<p>Scrappa's `GET /api/immoscout24-at/similar` endpoint finds listings similar to a given listing.

    ## How it works

    The portal names the filter set behind each listing (region, deal type, price ceiling, minimum area and rooms). The endpoint searches that filter set and removes the listing itself. The `filters` field shows what was searched. For new-build projects, `children` lists the units of the project.

    ## Billing

    This endpoint makes two lookups on the portal and is billed as one request.</p>

- **Documentation:** [https://scrappa.co/docs/immoscout24-at-api/immoscout24_at_similar](https://scrappa.co/docs/immoscout24-at-api/immoscout24_at_similar)
- **API group:** ImmobilienScout24 Austria API
- **Endpoint:** `GET https://scrappa.co/api/immoscout24-at/similar`

## 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 |
| --- | --- | --- | --- |
| `id` | string | Yes | Listing id (24 character hex string). |
| `size` | integer | No | Number of similar listings, 1 to 50. Defaults to 10. |

## Example response

```json
{
    "data": {
        "filters": {
            "region": "009001020",
            "transferType": "RENT"
        },
        "results": [
            {
                "exposeId": "69ce7e5fa2f80c1c0b85a932",
                "headline": "Momento Vienna",
                "primaryPrice": 1775
            }
        ],
        "children": [],
        "exposeId": "69ce7e3d6fd3644eae4a06ca",
        "totalHits": 68
    },
    "meta": {
        "attempts": 1,
        "billable": true,
        "duration_ms": 640
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | The requested listing, agency or place does not exist. Non-billable and not retryable. |
| 422 | Validation Error | A query parameter failed validation: a missing required value, an unsupported filter value or a number outside the documented range. Every filter value is checked before a request is made, so a typo is never answered with a plausible but unfiltered result. Non-billable. |
| 503 | Request Rejected | ImmobilienScout24 Austria answered with an application error, for example a region it does not know. Non-billable and not retryable: the same request fails the same way. Published as 503; branch on `meta.retryable` rather than on the status code. |
| 503 | Temporarily Unavailable | ImmobilienScout24 Austria could not be reached. Every attempt is made again on a fresh route before this is returned, so it is always retryable. The `failure_type` is one of `upstream_unreachable`, `transport_error`, `edge_blocked`, `rate_limited` or `attempts_exhausted`. Non-billable; a later request is worth making. |

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