Skip to content
Scrappa Get API key
Zimmo API 1 credit/request

Zimmo Agency Listings API Documentation

GET https://scrappa.co/api/zimmo/agency/listings

Zimmo Agency Listings API List all properties of one agency, for sale and for rent, with the same row format as the search endpoint. Narrow the list with the category, price and bedroom filters. All other search filters work here too.

Zimmo Agency Listings API Documentation 1 credit/request

Endpoint

Request preview
GET
https://scrappa.co/api/zimmo/agency/listings
Auth header
x-api-key
Cost
1 credit/request
agency_id = 1234567890
Response preview
200 OK
{
    "data": {
        "page": 1,
        "size": 10,
        "count": 1,
        "service": "buy",
        "has_more": true,
        "listings": [
            {
                "id": "c1f57e0f-12d1-403d-afbc-e67f4fb7c40a",
                "lat": 51.0611833,
                "lon": 3.7286453,
                "url": "https://www.zimmo.be/nl/gent-9000/te-koop/huis/LSOXI",
                "code": "LSOXI",
...

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

1 required parameter needed before sending a request.

10 optional filters available.

agency_id string Required

Agency id from the agencies endpoint.

Example value 1234567890
service string Optional

buy or rent. Without it both are returned.

Example value example
category string Optional

One or more, comma separated: house, apartment, commercial, garage, plot, room.

Example value example
price_min integer Optional

Minimum price in EUR. For rent this is the monthly rent.

Example value 10
price_max integer Optional

Maximum price in EUR. For rent this is the monthly rent.

Example value 10
bedrooms_min integer Optional

Minimum number of bedrooms.

Example value 10
sort string Optional

date, price, ranking or energy_label. Default date.

Example value relevance
order string Optional

asc or desc. Default asc for price and energy_label, desc for date and ranking.

Example value example
page integer Optional

Page number, 1 or more. Default 1. Zimmo returns results up to position 5000, so a deep page gives a 422 with the last page for your size.

Example value 1
size integer Optional

Rows per page, 1 to 30. Default 10. A Zimmo row is large (about 60 KB), so keep the size small.

Example value 10
locale string Optional

Language of the flat text fields (title, description, url, city): nl, fr, en or de. Default nl. The full text maps keep all languages.

Example value en-US

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

data meta success
JSON Response
200 OK
{
    "data": {
        "page": 1,
        "size": 10,
        "count": 1,
        "service": "buy",
        "has_more": true,
        "listings": [
            {
                "id": "c1f57e0f-12d1-403d-afbc-e67f4fb7c40a",
                "lat": 51.0611833,
                "lon": 3.7286453,
                "url": "https://www.zimmo.be/nl/gent-9000/te-koop/huis/LSOXI",
                "code": "LSOXI",
                "kind": "property",
                "urls": {
                    "fr": "https://www.zimmo.be/fr/gent-9000/a-vendre/maison/LSOXI",
                    "nl": "https://www.zimmo.be/nl/gent-9000/te-koop/huis/LSOXI"
                },
                "price": 675000,
                "title": "Lichtrijke en instapklare woning met charmante gevel en stadstuin nabij het Baudelopark.",
                "agency": {
                    "id": "75d5bb79-4273-4a50-8085-0cbc093e5d57",
                    "lat": 51.0492834,
                    "lon": 3.7271016,
                    "url": "https://www.zimmo.be/nl/vastgoedkantoor/gent-9000/carlo-eggermont-37045",
                    "logo": "https://files.zimmo.be/backend-api/YlO2SpeTAmR9kZXbPVaiNdqohUo=/filters:image-fo...",
                    "name": "Carlo Eggermont",
                    "slug": "carlo-eggermont-37045",
                    "phone": "+32492087047",
                    "address": {
                        "box": null,
                        "city": "Gent",
                        "number": "1-102",
                        "street": "Grote Huidevettershoek",
                        "country": "Belgium",
                        "postal_code": "9000",
                        "country_code": "BE"
                    },
                    "reviews": {
                        "combined": {
                            "max": 10,
                            "count": 65,
                            "score": 8.4
                        },
                        "external": {
                            "max": 5,
                            "count": 63,
                            "score": 4.3
                        },
                        "housematch": {
                            "max": 10,
                            "count": 2,
                            "score": 5.5
                        }
                    },
                    "website": "www.carloeggermont.be",
                    "category": "broker",
                    "mobile_phone": "+32492087047"
                },
                "estate": {
                    "note": "The full estate object follows the upstream record: layout, floors, utilities, flooding, planning and more. Shortened here.",
                    "type": "HOUSE",
                    "price": {
                        "unit": "EUR",
                        "value": 675000
                    },
                    "status": "FOR_SALE",
                    "subType": "HOUSE",
                    "condition": "GOOD_CONDITION",
                    "certificate": {
                        "asBuilt": {
                            "certificateStatus": "NOT_OBTAINED"
                        },
                        "epcCertificate": {
                            "epcValue": {
                                "unit": "kWh/m\u00b2",
                                "value": 118
                            },
                            "energyLabel": "B",
                            "certificateStatus": "OBTAINED",
                            "epcCertificateNumber": "3950907",
                            "renovationObligation": "UNKNOWN"
                        },
                        "electricityCertificate": {
                            "certificateStatus": "OBTAINED",
                            "electricityConformity": "VALID"
                        }
                    },
                    "constructionYear": 1850,
                    "floorspaceSurface": {
                        "unit": "m\u00b2",
                        "value": 209
                    }
                },
                "images": [
                    {
                        "url": "https://files.zimmo.be/backend-api/TlmcSYRp00h_h9_lry7-wj2kq8w=/1300x650/filters:image-format(pjpg)/-/real-estate/customers/b4fa4d68-4bae-11e9-922b-005056b768a1/dealers/75d5bb79-4273-4a50-8085-0cbc093e5d57/listings/c1f57e0f-12d1-403d-afbc-e67f4fb7c40a/images/01a1726f-2138-7b8b-8d2e-b2b53fc54fa3",
                        "order": 1,
                        "thumbnails": {
                            "z-detail-328": "https://files.zimmo.be/backend-api/iW9n6W5mT-3HAhqYtTItXVfMpwE=/328x164/filters:image-format(pjpg)/-/real-estate/customers/b4fa4d68-4bae-11e9-922b-005056b768a1/dealers/75d5bb79-4273-4a50-8085-0cbc093e5d57/listings/c1f57e0f-12d1-403d-afbc-e67f4fb7c40a/images/01a1726f-2138-7b8b-8d2e-b2b53fc54fa3",
                            "z-detail-672": "https://files.zimmo.be/backend-api/DqsYfTErdKbg3gnpTH0d7cmlGeg=/672x336/filters:image-format(pjpg)/-/real-estate/customers/b4fa4d68-4bae-11e9-922b-005056b768a1/dealers/75d5bb79-4273-4a50-8085-0cbc093e5d57/listings/c1f57e0f-12d1-403d-afbc-e67f4fb7c40a/images/01a1726f-2138-7b8b-8d2e-b2b53fc54fa3"
                        }
                    }
                ],
                "status": "FOR_SALE",
                "address": {
                    "box": null,
                    "city": "Gent",
                    "number": "6",
                    "street": "Jakob Van Caeneghemstraat",
                    "country": "Belgium",
                    "postal_code": "9000",
                    "country_code": "BE"
                },
                "area_m2": 209,
                "service": "buy",
                "bedrooms": 2,
                "category": "house",
                "currency": "EUR",
                "stickers": [
                    {
                        "type": "NEW",
                        "until": "2026-11-01T09:40:47Z"
                    }
                ],
                "sub_type": "house",
                "bathrooms": 1,
                "documents": [
                    {
                        "id": "01a1726f-3b3e-7f81-bbf3-01009be97c1c",
                        "url": "https://files.zimmo.be/backend-api/-/real-estate/customers/b4fa4d68-4bae-11e9-922b-005056b768a1/dealers/75d5bb79-4273-4a50-8085-0cbc093e5d57/listings/c1f57e0f-12d1-403d-afbc-e67f4fb7c40a/documents/01a1726f-3b3e-7f81-bbf3-01009be97c1c/2_MVO_Jakob Van Caeneghemstraat 6.pdf",
                        "name": "2_MVO_Jakob Van Caeneghemstraat 6.pdf"
                    }
                ],
                "epc_value": 118,
                "place_ids": [
                    1506,
                    3,
                    4,
                    580
                ],
                "created_at": "2026-10-25T09:40:46Z",
                "main_image": "https://files.zimmo.be/main-image/c1f57e0f-12d1-403d-afbc-e67f4fb7c40a",
                "updated_at": "2026-10-25T09:40:47Z",
                "description": "Lichtrijke en instapklare woning met charmante gevel en stadstuin nabij het Baudelopark.\n\nOp een aantrekkelijke locatie nabij het Industriemuseum en het Baudelopark bevindt zich deze woning, die in 2016 werd gerenoveerd met oog voor hedendaags wooncomfort. Ook Dok Noord, met zijn winkels, restaurant...",
                "energy_label": "B",
                "plot_area_m2": 135,
                "price_period": null,
                "project_link": null,
                "price_history": null,
                "cadastral_income": 642,
                "new_construction": false,
                "construction_year": 1850,
                "publication_start": "2026-10-25T09:40:47Z",
                "external_reference": "4493699",
                "coordinate_precision": "ROOFTOP"
            }
        ],
        "total_count": 96,
        "filters_applied": {
            "sort": "date",
            "order": "desc",
            "service": "buy",
            "agency_id": "75d5bb79-4273-4a50-8085-0cbc093e5d57"
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "search",
        "duplicates_removed": 0,
        "rows_removed_by_guard": 0
    },
    "success": true
}

Errors

Handle these documented responses before retrying or showing customer-facing failures.

422

Validation Error

A required parameter is missing or invalid. This response is not billable.

{
    "errors": {
        "agency_id": [
            "The agency_id is an id from the agencies endpoint."
        ]
    },
    "message": "The request validation failed"
}
503

Temporarily Unavailable

Zimmo did not answer or refused the request after several attempts. This response is not billable. Retry after a short pause.

{
    "meta": {
        "attempts": 3,
        "billable": false,
        "retryable": true
    },
    "error": {
        "message": "Zimmo data is temporarily unavailable. Please retry.",
        "failure_type": "upstream_unavailable"
    },
    "success": false
}

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Try It Live

Test this endpoint in our interactive playground with real data.