Pararius APIPararius.nl ↗
Search and retrieve rental property listings from Pararius.nl. Access pricing, area, rooms, agent info, photos, and full property features via 2 endpoints.
What is the Pararius API?
The Pararius.nl API provides access to rental property listings from the Netherlands' largest rental housing platform via 2 endpoints. search_rentals returns paginated results — approximately 30 listings per page — covering price, area, rooms, interior type, and agent info. get_listing_details returns full property descriptions, up to 10 photos, structured feature sets, and agent contact details for any individual listing.
curl -X GET 'https://api.parse.bot/scraper/de2b7dd4-2f82-4fac-b6dd-fb9ac24639a5/search_rentals?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-nl-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 listings SDK — search and inspect properties."""
from parse_apis.pararius_rental_listings_api import Pararius, City_, ListingNotFound
client = Pararius()
# Search Amsterdam rentals — limit caps total items fetched across all pages.
for listing in client.city(City_.AMSTERDAM).search(limit=5):
print(listing.title, listing.price, listing.area)
# Drill into the first listing's full details.
listing = client.city(City_.ROTTERDAM).search(limit=1).first()
if listing:
detail = listing.details()
print(detail.title, detail.price)
print(detail.address, detail.description[:120])
for key, val in detail.features.items():
print(f" {key}: {val}")
# Handle a missing listing gracefully.
try:
bogus = client.city("utrecht").search(limit=1).first()
if bogus:
bogus.details()
except ListingNotFound as exc:
print(f"listing gone: {exc.path}")
print("exercised: city.search / listing.details / ListingNotFound")
Search rental listings on Pararius. Returns a paginated list of available rental properties with key details like price, area, rooms, and agent info. Each page returns approximately 30 listings. Pagination advances by integer page number. Results are ordered by recency (newest first). The total_listings field is a site-rendered string count.
| Param | Type | Description |
|---|---|---|
| city | string | City or region to search in (e.g., 'amsterdam', 'rotterdam', 'den-haag'). Use 'nederland' for all of the Netherlands. |
| page | integer | Page number (1-based). |
{
"type": "object",
"fields": {
"city": "string, the city/region searched",
"page": "integer, current page number",
"count": "integer, number of listings returned on this page",
"listings": "array of listing objects with title, url, path, address, price, area, rooms, interior, agent",
"total_pages": "integer, total number of pages available",
"total_listings": "string, total number of listings displayed by the site"
},
"sample": {
"data": {
"city": "amsterdam",
"page": 1,
"count": 32,
"listings": [
{
"url": "https://www.pararius.nl/appartement-te-huur/amsterdam/ca325ca0/marco-polostraat",
"area": "51 m²",
"path": "/appartement-te-huur/amsterdam/ca325ca0/marco-polostraat",
"agent": "Grand Relocation",
"price": "€ 2.350 per maand",
"rooms": "4 kamers",
"title": "Appartement Marco Polostraat 195 1",
"address": "1057 WK Amsterdam (Hoofdweg e.o.)",
"interior": "Gestoffeerd"
}
],
"total_pages": 28,
"total_listings": "831"
},
"status": "success"
}
}About the Pararius API
Search Rental Listings
The search_rentals endpoint accepts a city parameter (e.g., amsterdam, rotterdam, den-haag) or nederland to query the entire country. Results are paginated with roughly 30 listings per page; the response includes total_pages and total_listings so you can walk through the full result set. Each listing object in the listings array contains title, url, address, price, area, rooms, interior, and agent — enough to build a filtered rental search tool or comparison table without fetching individual detail pages.
Listing Detail Data
The get_listing_details endpoint takes a path value pulled directly from the url field in search_rentals results (strip the domain prefix). It returns the full description text, a features object with key-value pairs covering attributes like build year, energy label, and floor area, a photos array of up to 10 image URLs, and the monthly price. The address field provides postal code and neighborhood. This endpoint is suited for building listing detail pages, enriching a property database, or running feature-level comparisons across rentals.
Coverage and Pagination
Pararius.nl covers rental properties across all Dutch cities and regions. The page parameter in search_rentals is 1-based, and you can determine how many pages exist from total_pages in the first response. City slugs follow Pararius URL conventions — hyphenated lowercase, matching how the site formats city names in its own listing URLs.
The Pararius API is a managed, monitored endpoint for Pararius.nl — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when Pararius.nl 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.nl 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?+
- Build a rental price monitor that tracks asking rents by city using
priceandcityfields fromsearch_rentals. - Aggregate energy label data across listings using the
featuresobject returned byget_listing_details. - Create a neighborhood comparison tool using
address,area, androomsfields across paginated search results. - Compile a photo gallery of available rentals by extracting the
photosarray from listing detail responses. - Track which real estate agents have the most active listings by counting
agentvalues across search results. - Build a new-listing alert system by periodically querying
search_rentalsfor a given city and diffingurlfields. - Populate a property database with build year, interior type, and floor area from the
featuresandinteriorresponse fields.
| 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.nl offer an official developer API?+
What does the `features` object in `get_listing_details` contain?+
features object contains key-value pairs of property attributes as listed on the detail page — this can include items like floor area, number of rooms, build year, energy label, interior type, and other property-specific fields. The exact keys vary by listing depending on what the landlord or agent has provided.Can I filter search results by price range, property type, or number of rooms?+
search_rentals endpoint currently filters by city and page only. It does not expose price range, property type, or room count as query parameters. You can fork this API on Parse and revise it to add those filter parameters.