Pararius APIpararius.com ↗
Search Dutch rental listings on Pararius, get full property details, look up agent portfolios, and autocomplete locations via a simple REST API.
What is the Pararius API?
The Pararius API exposes 4 endpoints for searching and retrieving rental property data from Pararius.com, one of the Netherlands' largest rental platforms. Use search_rental_listings to query listings by city with filters for price range, bedroom count, and furnishing, or call get_listing_detail to pull the full description, photos, characteristics, and agent contact for a single property. Responses include structured fields covering price, surface area, interior type, location, and more.
curl -X GET 'https://api.parse.bot/scraper/a823bbf5-63db-4be3-808d-17311f45e6f4/search_rental_listings?city=amsterdam&page=1' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace pararius-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Pararius rental search — find apartments, inspect details, browse agents."""
from parse_apis.pararius_rental_properties_api import Pararius, ListingNotFound
client = Pararius()
# Search rental listings in Amsterdam, capped at 5 results
for listing in client.listings.search(city="amsterdam", limit=5):
print(listing.title, listing.price, listing.location)
# Get location suggestions to discover valid search cities
for suggestion in client.locationsuggestions.search(query="rotterdam", limit=3):
print(suggestion.value, suggestion.type, suggestion.point)
# Drill into the first listing's full details (characteristics, photos, description)
listing = client.listings.search(city="utrecht", limit=1).first()
if listing:
detail = listing.details()
print(detail.title, detail.price, detail.location)
print(len(detail.photos), "photos available")
# Browse the managing agent's other listings
agent = listing.agent
for other in agent.listings(limit=3):
print(other.title, other.price, other.rooms)
# Typed error handling for a missing listing
try:
bad = client.agent(url="https://www.pararius.com/real-estate-agents/amsterdam/nonexistent-agent")
for l in bad.listings(limit=1):
print(l.title)
except ListingNotFound as exc:
print(f"Agent not found: {exc.url}")
print("exercised: listings.search / locationsuggestions.search / listing.details / agent.listings")
Search for rental property listings by city with optional filters and pagination. Returns a paginated list of listings with basic info like price, location, rooms, and managing agent. Paginated by page number; each page returns up to ~30 listings.
| Param | Type | Description |
|---|---|---|
| cityrequired | string | City name to search in, lowercase (e.g. amsterdam, rotterdam, utrecht, den-haag, eindhoven, groningen). Use suggest_locations to discover valid city names. |
| page | integer | Page number for pagination. |
| filters | string | URL path filter segments for narrowing results (e.g. /0-1500/2-bedrooms/furnished). Multiple filters are concatenated as path segments. |
{
"type": "object",
"fields": {
"city": "string, the city searched",
"page": "string, the current page number",
"listings": "array of listing objects with id, title, url, price, location, surface_area, rooms, interior, agent, and status",
"total_count": "string, total number of matching listings"
},
"sample": {
"data": {
"city": "amsterdam",
"page": "1",
"listings": [
{
"id": "6aba9140",
"url": "https://www.pararius.com/apartment-for-rent/amsterdam/6aba9140/simon-stevinstraat",
"agent": {
"url": "https://www.pararius.com/real-estate-agents/rotterdam/property-partner",
"name": "Property Partner"
},
"price": "€2,500 pcm",
"rooms": "2 rooms",
"title": "Flat Simon Stevinstraat",
"status": "Highlighted",
"interior": "Furnished",
"location": "1097 CA Amsterdam (Frankendael)",
"surface_area": "49 m²"
}
],
"total_count": "32"
},
"status": "success"
}
}About the Pararius API
Search and Filter Rental Listings
The search_rental_listings endpoint accepts a required city parameter (lowercase, e.g. amsterdam, rotterdam) and an optional filters string built from URL path segments such as /0-1500/2-bedrooms/furnished. This lets you narrow results by maximum rent, bedroom count, and furnishing status in a single call. The response includes a listings array — each object carrying id, title, url, price, location, surface_area, rooms, interior, agent, and status — plus a total_count string and the current page number for pagination.
Full Listing Details and Agent Data
get_listing_detail takes the full Pararius listing URL and returns an expanded payload: a description string, a photos array of image URLs, a characteristics object with categorized attributes (Transfer, Area and capacity, Construction, etc.), the rental price, and an agent object containing the managing estate agent's name and profile URL. For agent-level queries, get_agent_listings accepts an agent profile URL and returns all their active rental listings in the same listing-array format as the search endpoint, plus a total_count integer.
Location Autocomplete
suggest_locations resolves a free-text query — a city name, district, or neighbourhood like de pijp — into structured suggestion objects, each with a value, type (city, district, neighbourhood), filters string ready to pass into search_rental_listings, and point coordinates. This makes it straightforward to build a location picker that feeds directly into search queries without hardcoding filter paths.
The Pararius API is a managed, monitored endpoint for pararius.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when pararius.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official pararius.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Aggregate Amsterdam and Rotterdam rental listings with price and surface area for market-rate analysis.
- Build a rental alert system that polls
search_rental_listingswith price and bedroom filters and flags new listings. - Display full property detail pages in a custom app using
get_listing_detailfor description, photos, and characteristics. - Map listings geographically by resolving neighbourhoods to coordinates via
suggest_locationspoint data. - Audit an estate agent's active rental portfolio using
get_agent_listingsfor competitive research. - Power a location autocomplete field that converts free-text neighbourhood input into valid search filter segments.
- Track furnished vs. unfurnished inventory trends across Dutch cities using the
interiorfield in listing responses.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Pararius offer an official developer API?+
What filters can I apply in `search_rental_listings`?+
filters parameter. You can combine price ceiling (e.g. /0-1500), bedroom count (e.g. /2-bedrooms), and furnishing status (e.g. /furnished) in one string. The suggest_locations endpoint returns ready-made filters strings you can pass directly into this parameter.