# Bien'ici Listing

The listing route the production site itself uses. Returns the full ad with photos, description, energy rating, and coordinates. The structured agent contact block is removed and never returned; the ad's agency business identifiers are kept. The seller's own `description` text is passed through unchanged, so it may contain a phone number or email address the seller wrote there. Price is normalized to min/max/currency/disclosed with unit "total", so a new-build price range reads correctly.

- **Documentation:** [https://scrappa.co/docs/bienici-api/bienici_listing](https://scrappa.co/docs/bienici-api/bienici_listing)
- **API group:** Bien'ici API
- **Endpoint:** `GET https://scrappa.co/api/bienici/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 |
| --- | --- | --- | --- |
| `ad_id` | string | Yes | Listing id from the search endpoint. A hyphenated string such as ag750725-49688129. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/bienici/listing?ad_id=ag750725-49688129"
```

## Example response

```json
{
    "success": true,
    "data": {
        "ad": {
            "id": "ag750725-49688129",
            "title": "QUARTIER RESIDENTIEL OUDINOT 7\u00e8me",
            "transactionType": "rent",
            "propertyType": "flat",
            "price": {
                "min": null,
                "max": null,
                "currency": null,
                "disclosed": false,
                "unit": "total"
            },
            "reference": "602996",
            "surfaceArea": 40,
            "roomsQuantity": 2,
            "city": "Paris",
            "postalCode": "75007",
            "hasContactData": false
        }
    },
    "meta": {
        "endpoint_family": "listing"
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | The requested house was not found. This response is not billable. |
| 422 | Validation Error | A public parameter is invalid. This response is not billable. |
| 503 | Service Unavailable | The service could not obtain a complete result. 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)