Ga naar inhoud
HuislyHuisly
Huisly Data
Inloggen
StatusLivePOST /data/v1/listings/search

Aggregator API

Zoek open Nederlandse advertenties te huur en te koop via een REST API. De nieuwste advertenties komen eerst.

Account aanmakenLees de documentatie
Voorbeeldverzoeken aan de API. Voorbeelddata uit het gepubliceerde API-contract.
Aanbod

Verzoek

POST/data/v1/listings/search

X-API-Key: YOUR_API_KEY{"listingType": "for-sale", "places": [{"type": "municipality", "slug": "amsterdam-gsxxzjaz98rj"}], "limit": 20}

Antwoord

{
  "data": [
    {
      "id": "0b7c7a8e-4f3e-4a51-9a39-2f1d3f5c6a10",
      "listingType": "for-sale",
      "propertyType": "apartment",
      "priceCents": "42500000",
      "livingAreaM2": 92,
      "bedrooms": 2,
      "rooms": 3,
      "constructionYear": 1932,
      "energyLabel": "c",
      "furnishingStatus": null,
      "hasApplicationFee": false,
      "listedAt": "2026-11-08T16:04:46.864Z",
      "location": {
        "municipality": {
          "slug": "amsterdam-gsxxzjaz98rj",
          "displayName": "Amsterdam"
        },
        "locality": {"slug": "amsterdam-c7sh2t", "displayName": "Amsterdam"},
        "district": {
          "slug": "grachtengordel-west-mavt2wcj84gj",
          "displayName": "Grachtengordel-West"
        },
        "neighborhood": {
          "slug": "langestraat-e-o-jtvr6xz675kh",
          "displayName": "Langestraat e.o."
        },
        "postalCode": {"slug": "1015-cc-7j7dqke625ht", "displayName": "1015 CC"},
        "publicSpace": {
          "slug": "keizersgracht-9z4dabpr",
          "displayName": "Keizersgracht"
        }
      },
      "houseNumber": "999",
      "houseLetter": null,
      "houseNumberAddition": "2",
      "propertySlug": "amsterdam-keizersgracht-999-2-k8d3m2p9x4qz",
      "images": [
        {
          "url": "https://listing-media.voseno.com/images/0b7c7a8e-4f3e-4a51-9a39-2f1d3f5c6a10-1.webp"
        }
      ]
    }
  ],
  "pagination": {"nextCursor": null, "limit": 20}
}

200 OK1 creditVoorbeeldantwoord

Voorbeelddata uit het gepubliceerde API-contract.

  • 1 creditper zoekopdracht
  • 50advertenties per pagina, maximaal
  • 10plaatsen per zoekopdracht, maximaal
  • Nieuwste eersteen vaste volgorde, op tijdstip van plaatsing

Endpoints

Het basisadres is https://api.huisly.nl. Stuur je API-sleutel mee in de header X-API-Key.

  • POST/data/v1/listings/searchZoek open advertenties in 1 tot 10 plaatsen.1 credit
  • GET/data/v1/places/searchVind plaatsen en hun slugs op naam, postcode of straat. Geeft maximaal 5 plaatsen terug.Gratis
  • GET/data/v1/balanceControleer je API-sleutel en je creditsaldo.Gratis

Filters

Allemaal optioneel.

  • Type pand
  • Prijs
  • Woonoppervlak
  • Slaapkamers
  • Kamers
  • Bouwjaar
  • Energielabel
  • Inrichting
  • Aanvraagkosten

Paginering

nextCursor

Een pagina heeft maximaal 50 advertenties, standaard 20, de nieuwste eerst. Wil je verder lezen, stuur dan de nextCursor van een pagina als cursor mee in het volgende verzoek.

propertySlug

Een advertentie die aan een adres is gekoppeld, heeft de slug van dat adres in propertySlug.

Property API

Over de data

  • Het aanbod komt van 3.000+ Nederlandse woningwebsites die Huisly volgt.

  • Huisly voegt 99% van de dubbele advertenties samen voor woningen met een volledig adres. Advertenties zonder adres worden niet ontdubbeld.

Roep hem aan vanuit je code

Kosten

Een zoekopdracht naar advertenties kost 1 credit en geeft maximaal 50 advertenties terug. De plaatsenzoeker en het saldo zijn gratis. Een mislukt verzoek kost niets.

Lees de documentatie

API-sleutels beginnen met vos_live_.

curl -X POST https://api.huisly.nl/data/v1/listings/search \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"listingType":"for-sale","places":[{"type":"municipality","slug":"amsterdam-gsxxzjaz98rj"}],"limit":20}'
const response = await fetch("https://api.huisly.nl/data/v1/listings/search", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    listingType: "for-sale",
    places: [{ type: "municipality", slug: "amsterdam-gsxxzjaz98rj" }],
    limit: 20,
  }),
})
const { data, pagination } = await response.json()
import requests

response = requests.post(
    "https://api.huisly.nl/data/v1/listings/search",
    headers={"X-API-Key": "YOUR_API_KEY"},
    json={
        "listingType": "for-sale",
        "places": [{"type": "municipality", "slug": "amsterdam-gsxxzjaz98rj"}],
        "limit": 20,
    },
)
page = response.json()

Probeer het met gratis credits

Een nieuwe organisatie kan gratis proefcredits claimen om de API uit te proberen.

Account aanmakenBekijk de prijzen

Vragen

Gesprek inplannenof mailsales@huisly.nl