# Daft — 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 property listings for sale and rental across Ireland with customizable filters, then view complete details for any property that interests you. Access real-time data directly from Ireland's largest property marketplace to find your next home or investment.

**Category:** Real Estate | **Website:** [daft.ie/](https://daft.ie/) | **Docs:** [parse.bot/marketplace/b471de49-5209-467f-8666-acc7c65f4f6f/daft-ie-api](https://parse.bot/marketplace/b471de49-5209-467f-8666-acc7c65f4f6f/daft-ie-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-daft-ie-api-b471de49/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_listing

Get full details for a specific property listing by its seoFriendlyPath (obtained from search results). Returns comprehensive data including description, features, seller contact info, images, BER rating, address details, floor area, and viewing times.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `path` | string | Yes | The seoFriendlyPath from a search result (e.g. '/for-sale/apartment-16-37-main-street-clongriffin-dublin-13/6593191'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-daft-ie-api-b471de49/get_listing \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"path":"<string>"}'
```

### search

Search property listings on Daft.ie by location and category with optional filters. Returns paginated results (20 per page) including listing summaries with price, bedrooms, bathrooms, property type, seller info, and media. Pagination uses integer page numbers; each listing carries a seoFriendlyPath for detail lookup.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `beds` | integer | No | Number of bedrooms to filter by. |
| `category` | string | No | Listing category. |
| `location` | string | No | Location slug for the search area (e.g. 'ireland', 'dublin-city', 'cork-county', 'galway-city'). |
| `max_price` | integer | No | Maximum price filter (sale price in EUR or monthly rent depending on category). |
| `min_price` | integer | No | Minimum price filter (sale price in EUR or monthly rent depending on category). |
| `page` | integer | No | Page number (starts at 1). |
| `property_type` | string | No | Type of property (e.g. 'house', 'apartment', 'duplex', 'bungalow', 'townhouse'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-daft-ie-api-b471de49/search \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"beds":"<integer>","category":"<string>","location":"<string>","max_price":"<integer>","min_price":"<integer>","page":"<integer>","property_type":"<string>"}'
```