# Pararius — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and browse rental property listings on Pararius.com. Filter by city, price, size, and furnishing; retrieve full property details; look up listings by estate agent; and autocomplete location queries.

**Category:** Real Estate | **Website:** [pararius.com/](https://pararius.com/) | **Docs:** [parse.bot/marketplace/699a131c-7342-45d3-a392-b44ff7987fbd/pararius-com-api](https://parse.bot/marketplace/699a131c-7342-45d3-a392-b44ff7987fbd/pararius-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-pararius-com-api-699a131c/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_agent_listings

Retrieve all rental listings managed by a specific estate agent. Provide the agent profile URL and the scraper navigates to their rental properties page. Returns all listings currently managed by that agent.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `agent_url` | string | Yes | Agent profile URL (e.g. https://www.pararius.com/real-estate-agents/rotterdam/property-partner). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pararius-com-api-699a131c/get_agent_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"agent_url":"<string>"}'
```

### get_listing_detail

Get full details of a single property listing including characteristics, description, photos, and agent info. Requires the full Pararius listing URL. Returns structured property data with categorized characteristics (Transfer, Area and capacity, Construction, etc.).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the listing detail page (e.g. https://www.pararius.com/apartment-for-rent/amsterdam/6aba9140/simon-stevinstraat). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pararius-com-api-699a131c/get_listing_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### search_rental_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.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | Yes | City name to search in, lowercase (e.g. amsterdam, rotterdam, utrecht, den-haag, eindhoven, groningen). Use suggest_locations to discover valid city names. |
| `filters` | string | No | URL path filter segments for narrowing results (e.g. /0-1500/2-bedrooms/furnished). Multiple filters are concatenated as path segments. |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pararius-com-api-699a131c/search_rental_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>","filters":"<string>","page":"<integer>"}'
```

### suggest_locations

Get location suggestions (city, district, neighbourhood) for a search query. Returns matching locations with their filter parameters and coordinates, useful for discovering valid city names to pass to search_rental_listings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search query for location autocomplete (e.g. amsterdam, rotterdam, de pijp, utrecht). Any partial or full location name. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pararius-com-api-699a131c/suggest_locations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```