# Property Finder Listing API Documentation

Returns one Property Finder listing by its id: description and a plain-text twin, price, area with coordinates, the property, community and tower image sets, floor plans, amenities, the agent and brokerage, RERA and licence details, listing dates and the listing flags. An unknown id answers a non-billed 404.

- **Documentation:** [https://scrappa.co/docs/propertyfinder-api/propertyfinder_listing](https://scrappa.co/docs/propertyfinder-api/propertyfinder_listing)
- **API group:** Property Finder API
- **Endpoint:** `GET https://scrappa.co/api/propertyfinder/listing`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | Yes | Listing id from a search result, e.g. 159607863. |
| `locale` | string | No | en or ar. Defaults to en. |
| `country` | string | No | ae, sa, qa, bh or eg. Defaults to ae. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/propertyfinder/listing?id=159607863"
```

## Example response

```json
{
    "success": true,
    "data": {
        "property": {
            "id": "159607863",
            "reference": "J3RZBTSW5Y5YQDJ3Q83QS7K2AW",
            "price": {
                "value": 1780000,
                "currency": "AED"
            },
            "agent": {
                "id": "299087"
            }
        }
    },
    "meta": {
        "endpoint_family": "listing",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | Error | No listing carries that id. Not billed. |
|  | Error | Property Finder could not be reached. Not billed. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)