# Zimmo Agency Listings API Documentation

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.

- **Documentation:** [https://scrappa.co/docs/zimmo-api/zimmo_agency_listings](https://scrappa.co/docs/zimmo-api/zimmo_agency_listings) - **API group:** Zimmo API - **Endpoint:** `GET https://scrappa.co/api/zimmo/agency/listings` ## 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 | | --- | --- | --- | --- | | `agency_id` | string | Yes | Agency id from the agencies endpoint. | | `service` | string | No | buy or rent. Without it both are returned. | | `category` | string | No | One or more, comma separated: house, apartment, commercial, garage, plot, room. | | `price_min` | integer | No | Minimum price in EUR. For rent this is the monthly rent. | | `price_max` | integer | No | Maximum price in EUR. For rent this is the monthly rent. | | `bedrooms_min` | integer | No | Minimum number of bedrooms. | | `sort` | string | No | date, price, ranking or energy_label. Default date. | | `order` | string | No | asc or desc. Default asc for price and energy_label, desc for date and ranking. | | `page` | integer | No | 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. | | `size` | integer | No | Rows per page, 1 to 30. Default 10. A Zimmo row is large (about 60 KB), so keep the size small. | | `locale` | string | No | 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 response ```json { "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 | Status | Error | Description | | --- | --- | --- | | 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)