pararius.com APIpararius.com ↗
Search Dutch rental listings on Pararius, get full property details, look up agent portfolios, and autocomplete locations via a simple REST API.
curl -X GET 'https://api.parse.bot/scraper/a823bbf5-63db-4be3-808d-17311f45e6f4/search_rental_listings?city=amsterdam' \ -H 'X-API-Key: $PARSE_API_KEY'
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.
| Param | Type | Description |
|---|---|---|
| cityrequired | string | City name to search in, lowercase (e.g. amsterdam, rotterdam, utrecht). |
| 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": "1cfc7f2f",
"url": "https://www.pararius.com/apartment-for-rent/amsterdam/1cfc7f2f/elisabeth-wolffstraat",
"agent": {
"url": "https://www.pararius.com/real-estate-agents/amsterdam/noorestate",
"name": "NOORESTATE"
},
"price": "€2,750 pcm",
"rooms": "3 rooms",
"title": "Flat Elisabeth Wolffstraat",
"status": "Highlighted",
"interior": "Furnished",
"location": "1053 TS Amsterdam (Bellamybuurt)",
"surface_area": "65 m²"
}
],
"total_count": "32"
},
"status": "success"
}
}About the pararius.com 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.
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.
- 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 | 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 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.