# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/daft/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/daft/get-listing \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/daft/search \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"beds":"<integer>","category":"<string>","location":"<string>","max_price":"<integer>","min_price":"<integer>","page":"<integer>","property_type":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.