# Habitaclia Listing API Documentation

Returns the full record for one listing, addressed by the ad_id UUID from a search or publisher item. The record carries the complete description, the postal address, the publisher, the price history, the energy certificate and the media sets (images, videos, virtual tours and documents; a floor plan is a document with type FLOOR_PLAN). An unknown id answers a 404 with error.code NOT_FOUND, which is not billable.

- **Documentation:** [https://scrappa.co/docs/habitaclia-api/habitaclia_listing](https://scrappa.co/docs/habitaclia-api/habitaclia_listing)
- **API group:** Habitaclia API
- **Endpoint:** `GET https://scrappa.co/api/habitaclia/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 | The ad_id UUID from a search or publisher item, for example 82d1e398-a167-465a-bfe9-465afb9197d5. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/habitaclia/listing?id=82d1e398-a167-465a-bfe9-465afb9197d5"
```

## Example response

```json
{
    "success": true,
    "data": {
        "ad_id": "82d1e398-a167-465a-bfe9-465afb9197d5",
        "legacy_id": "i55824000002922",
        "url": "https://www.habitaclia.com/i55824000002922.htm",
        "reference": "VIRIA-13",
        "property_type": "flat",
        "property_subtype": "flat",
        "transaction_type": "buy",
        "price": 545000,
        "currency": "EUR",
        "rooms": 2,
        "bathrooms": 2,
        "built_surface": 94,
        "state": "PUBLISHED",
        "publisher": {
            "id": "7f0a4bc7-bae1-483f-a90d-0b94dcf276aa",
            "name": "AEDAS HOMES",
            "trade_name": "AEDAS HOMES"
        },
        "created_at": "2026-09-22T08:46:03Z"
    },
    "meta": {
        "endpoint_family": "listing",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | The requested listing was not found. This response is not billable. |
| 422 | Validation Error | A public parameter is invalid, including an unknown transaction_type, property_type or sort_by. This response is not billable. |
| 503 | Service Unavailable | The service could not obtain a complete result from Habitaclia. This response is not billable. |

## 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)