# 4zida Listing Detail API Documentation

Read one listing by the 24 character id from /search. The answer is grouped: price with previous price, price per square metre, average sale price per square metre, deposit and utility costs; details with area, rooms, bathrooms, toilets, kitchen, balcony, loggia, terrace, floor, total floors, year, state, furnishing, heating and land registry status; the address with street, place chain and slugs; latitude and longitude when the seller shows them; further attributes such as elevator, parking, orientation and appliances; every photo in several sizes; the description; and the advertiser with the agency. Photo links are signed by 4zida and may expire, so fetch them soon. Phone numbers are never returned. An unknown id is a non-billable 404.

- **Documentation:** [https://scrappa.co/docs/4zida-api/fourzida_listing](https://scrappa.co/docs/4zida-api/fourzida_listing)
- **API group:** 4zida API
- **Endpoint:** `GET https://scrappa.co/api/4zida/v1/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 | 24 character listing id from /search, for example 6a3964dc4344218a2d00fd24. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/4zida/v1/listing?id=6a3964dc4344218a2d00fd24"
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A public parameter is missing, unknown or invalid, or 4zida cannot resolve a filter value. The response is not billable. |
| 404 | Resource Not Found | The requested 4zida resource does not exist. The response is not billable. |
| 503 | Unexpected Upstream Response | 4zida answered with a body that is not the documented shape. The response is not billable. |
| 503 | Upstream Unavailable | 4zida was temporarily unavailable or blocked the request. The response is not billable and the request never answers 429. |

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