# Zimmo Listing Scores API Documentation

<p><strong>Zimmo Listing Scores API</strong> Get the scores Zimmo shows for a listing: mobility (public transport, schools, shops, health care), transparency of the ad, popularity, an asking price estimate with a low, middle and high value, the market comparison by area and similar sold homes.</p><p>Use the listing <code>code</code> from the search endpoint.</p>

- **Documentation:** [https://scrappa.co/docs/zimmo-api/zimmo_scores](https://scrappa.co/docs/zimmo-api/zimmo_scores)
- **API group:** Zimmo API
- **Endpoint:** `GET https://scrappa.co/api/zimmo/listing/scores`

## 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 |
| --- | --- | --- | --- |
| `code` | string | Yes | Listing code (code) from the search endpoint, e.g. LSOXI. |

## Example response

```json
{
    "data": {
        "code": "LSOXI",
        "mobility_score": {
            "nl": {
                "totaal": 9.4,
                "openbaar_vervoer": {
                    "distances": {
                        "bus": {
                            "distance": 0.241421,
                            "distance_description": "Er is op minder dan 250m een belangrijke bushalte aanwezig"
                        },
                        "tram": {
                            "distance": 0.241421,
                            "distance_description": "Er is op minder dan 250m een tramhalte aanwezig"
                        },
                        "trein": {
                            "distance": 1.00711,
                            "distance_description": "Er is op minder dan 2km een treinstation aanwezig"
                        }
                    },
                    "score_description": "Uitstekend aanbod"
                }
            }
        },
        "similar_estates": [
            {
                "price": 648000,
                "archiveDate": "2026-02-16",
                "plotSurface": 74,
                "bedroomsCount": 2,
                "livingAreaSurface": 164
            }
        ],
        "popularity_score": {
            "score": 100
        },
        "price_estimation": {
            "errors": [],
            "estimation": {
                "plot_price": null,
                "rent_price": null,
                "plot_price_psqm": null,
                "asking_price_q25": 549090,
                "asking_price_q50": 648349.9009421375,
                "asking_price_q75": 765635
            },
            "extrapolated_low": false,
            "extrapolated_high": false
        },
        "market_comparison": "Price history per living area section. Shortened here.",
        "transparency_score": {
            "max": 98,
            "score": 93,
            "details": {
                "main": {
                    "price": {
                        "max": 16,
                        "amount": 16
                    },
                    "number": {
                        "max": 3,
                        "amount": 3
                    },
                    "street": {
                        "max": 13,
                        "amount": 13
                    },
                    "bedrooms": {
                        "max": 6,
                        "amount": 6
                    },
                    "has_photo": {
                        "max": 8,
                        "amount": 8
                    },
                    "land_surface": {
                        "max": 2,
                        "amount": 2
                    },
                    "photo_amount": {
                        "max": 5,
                        "amount": 5
                    }
                },
                "bonus": {
                    "virtual_tour": {
                        "max": 5,
                        "amount": 0
                    },
                    "price_history": {
                        "max": 20,
                        "amount": 20
                    },
                    "market_comparison": {
                        "max": 20,
                        "amount": 20
                    }
                }
            }
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "scores"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | The requested Zimmo listing was not found. Check the id: use the code or the id from the search endpoint. This response is not billable. |
| 422 | Validation Error | A required parameter is missing or invalid. This response is not billable. |
| 503 | Temporarily Unavailable | Zimmo did not answer or refused the request after several attempts. This response is not billable. Retry after a short pause. |

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