# Funda Similar Listings API Documentation

<p><strong>Funda Similar Listings API Documentation</strong> Retrieve the global ids of listings that Funda shows as similar to one listing, split into recently listed and recently sold. Open each global id with the listing endpoint. The id must be a global id (the global_id field of the listing endpoint).</p>

- **Documentation:** [https://scrappa.co/docs/funda-api/funda_similar](https://scrappa.co/docs/funda-api/funda_similar)
- **API group:** Funda API
- **Endpoint:** `GET https://scrappa.co/api/funda/listing/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` | integer | Yes | Funda global id as an integer, e.g. 7999691. Take it from global_id of the listing endpoint. |

## Example response

```json
{
    "data": {
        "global_id": 7999691,
        "recently_sold": [
            {
                "global_id": 7999600
            }
        ],
        "recently_listed": [
            {
                "global_id": 7999700
            },
            {
                "global_id": 7999701
            }
        ]
    },
    "meta": {
        "billable": true,
        "endpoint_family": "similar"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing or invalid. No upstream request is made. This response is not billable. |
| 404 | Listing Not Found | No Funda listing exists for the requested id. This response is not billable and is not retried. |
| 502 | Unexpected Response | Funda returned data in an unexpected shape. This response is not billable. Retry later. |
| 503 | Funda Unavailable | Funda could not be reached or blocked the request after retries. This response is not billable. Retry shortly. |

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