Skip to main content
The Stream Estate API lets you query real estate properties, adverts, and market indicators over HTTP. This guide takes you from zero to your first working request.

​
Prerequisites

  • A Stream Estate account — sign up if you don’t have one.
  • An API key. Create one in your account settings and keep it secret.
Every request is authenticated with the X-API-KEY header. There is no other auth step: no OAuth flow, no tokens to refresh.

​
Make your first request

The call below returns houses for sale in the Seine-et-Marne department (77), created since 2020, within a €1.8M–1.9M budget. 
curl --location -g --request GET \
  'https://api.stream.estate/documents/properties?includedDepartments[]=departments/77&fromDate=2020-01-10&propertyTypes[]=1&transactionType=0&withCoherentPrice=true&budgetMin=1800000&budgetMax=1900000' \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <your_api_key>'
A successful response is a Hydra collection: matching properties are in hydra:member, and hydra:totalItems holds the total count. See the Properties reference for the full response shape.

​
Understand the parameters

The example above uses only documented enum values:
ParameterValueMeaning
propertyTypes[]1House — Apartment 0, House 1, Building 2, Parking 3, Office 4, Land 5, Shop 6
transactionType0Sell 0, Rent 1
includedDepartments[]departments/77Restrict to a department — get ids from Locations
withCoherentPricetrueExclude listings whose price is flagged as incoherent
budgetMin / budgetMax1800000 / 1900000Budget range, in euros
The Properties reference lists every available filter.

​
Next steps

Core concepts

Properties, adverts, events, searches, and webhooks explained.

Authentication

How to create and use your API key.

Browse properties

Every filter available on the properties endpoint.

Searches & webhooks

Get notified in real time when new properties match a saved search.