Pararius.nl 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.
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'
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.
| 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, 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/9f9d422e/prins-hendrikkade",
"area": "70 m²",
"agent": "ViaDaan",
"price": "€ 2.600 per maand",
"rooms": "2 kamers",
"title": "Appartement Prins Hendrikkade 86 A",
"address": "1012 AE Amsterdam (Burgwallen-Oude Zijde)",
"interior": "Gemeubileerd"
}
],
"total_pages": 29,
"total_listings": "848"
},
"status": "success"
}
}About the Pararius.nl 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.
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.
- 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 | 250 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.