Authenticatie, invoer en resultaat

Beoordeel het volledige potentieel van de AutoSearch API door de belangrijkste parameters en de reactie te begrijpen

GEThttps://api.altum.ai/autosearch?search=

Het eindpunt stelt je in staat om met de Autosearch API te communiceren door specifieke queries te verzenden, zoals postcodes, sorteeropties en limieten op het aantal resultaten, om gedetailleerde vastgoedgegevens op te halen. Je kunt het volledige eindpunt hierboven vinden.

Query Parameters

Naam	Type	Omschrijving
search*	string	Deze parameter gebruikt de postcode die moet worden opgevraagd.
sort	string	Sorteer op "datum" of "relevantie". Standaard is datum.
limit	int	Maximaal aantal objecten in de reactie.

Headers

Content-Type	string	application/json
x-api-key*	string	Unieke API-sleutel van Altum. Maak er een op https://platform.altum.ai

Respons

De output van de Autosearch API is een lijst van objecten met de volgende velden:

Naam	Type	Omschrijving
postcode	string	Postcode van de locatie.
housenumber	int	Huisnummer van de locatie.
houseaddition	string	Eventuele toevoeging aan het huisnummer (bijv. "Hs+1")
city	string	Stad of dorp van de locatie.
street	string	Straatnaam van de locatie
province	string	Provincie van de locatie.
asking_price	int	Vraagprijs van het pand.
date_listed	string	Datum waarop het pand is vermeld (dd/mm/jj).
image	string	URL van de afbeelding van het pand (indien beschikbaar).
market_status	string	De huidige marktstatus van het eigendom en de mogelijke waarden: 'Beschikbaar', 'Verkocht onder voorbehoud', 'Onder bod', 'Onder optie', 'Verkocht', 'Alleen bij goed bod', 'Op termijn te koop'.

Voorbeeld Output

200

  
[
    {
        "postcode": "1053BM",
        "housenumber": 26,
        "houseaddition": "Hs+1",
        "city": "Amsterdam Bellamybuurt-Zuid",
        "street": "Bellamystraat",
        "province": "Noord-Holland",
        "asking_price": 925000,
        "date_listed": "18/04/24",
        "image": "https://altum-ai.s3.amazonaws.com/image-16258e96-e073-4d61-aec5-555f38c33ca7.png"
    },
    {
        "postcode": "1053BP",
        "housenumber": 72,
        "houseaddition": null,
        "city": "Amsterdam Bellamybuurt-Zuid",
        "street": "Bellamystraat",
        "province": "Noord-Holland",
        "asking_price": 1150000,
        "date_listed": "30/03/24",
        "image": "https://altum-ai.s3.amazonaws.com/image-cbfa1bb7-ae54-4852-87f4-f69574f27155.png"
    }
]

400

{
  "error": "Invalid request"
}