# Yaencontre Listing

Returns the full listing record for one reference, including the energy certificate, features, floorplans, photos at three widths, videos, 360 tours and 3D tours. Price is integer euros and availability is the available flag derived from the listing status.

- **Documentation:** [https://scrappa.co/docs/yaencontre-api/yaencontre_listing](https://scrappa.co/docs/yaencontre-api/yaencontre_listing)
- **API group:** Yaencontre API
- **Endpoint:** `GET https://scrappa.co/api/yaencontre/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 |
| --- | --- | --- | --- |
| `reference` | string | Yes | Listing reference from a search result, for example 66504-112724772. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/yaencontre/listing?reference=66504-112724772"
```

## Example response

```json
{
    "success": true,
    "data": {
        "listing": {
            "reference": "66504-112724772",
            "price": 549000,
            "energy_certificate_rating": "D",
            "available": true,
            "images": [
                {
                    "slug": "66504/66504-57645603-1523803950.jpg",
                    "caption": "sal\u00f3n",
                    "widths": [
                        "https://media.yaencontre.com/img/photo/380/66504/66504-57645603-1523803950.webp",
                        "https://media.yaencontre.com/img/photo/630/66504/66504-57645603-1523803950.webp",
                        "https://media.yaencontre.com/img/photo/1024/66504/66504-57645603-1523803950.webp"
                    ],
                    "fallback_url": "https://media.yaencontre.com/img/photo/1024/66504/66504-57645603-1523803950.jpg"
                }
            ]
        }
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | The requested listing reference does not exist. This response is not billable. |
| 422 | Validation Error | A public parameter is invalid, including rejected property types and transfer-only family pairings. This response is not billable and never reaches the origin. |
| 503 | Service Unavailable | The origin could not serve the request, or no usable network egress was available. This response is not billable; retry shortly. |

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