# Imovirtual Listing Detail API Documentation

Retrieve one Imovirtual listing by its slug from a search result: title, plain-text description, estate, transaction, market, status, reference, timestamps, price and price per square meter, area, rooms, bathrooms, floor, build year, energy certificate, the full characteristics and attributes tables, images, location and agency. An unknown slug returns a non-billable 404.

- **Documentation:** [https://scrappa.co/docs/imovirtual-api/imovirtual_listing](https://scrappa.co/docs/imovirtual-api/imovirtual_listing)
- **API group:** Imovirtual API
- **Endpoint:** `GET https://scrappa.co/api/imovirtual/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 |
| --- | --- | --- | --- |
| `slug` | string | Yes | Listing slug from a search result, e.g. apartamento-t2-com-logradouro-ID1j1sE. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/imovirtual/listing?slug=apartamento-t2-com-logradouro-ID1j1sE"
```

## Example response

```json
{
    "success": true,
    "data": {
        "id": 19310188,
        "url": "https://www.imovirtual.com/pt/anuncio/apartamento-t2-com-logradouro-ID1j1sE",
        "title": "Apartamento T2 com logradouro",
        "estate": "FLAT",
        "transaction": "SELL",
        "price": {
            "value": 359900,
            "currency": "EUR"
        },
        "areaInSquareMeters": 57,
        "roomsNumber": 3,
        "bathroomsNumber": 1,
        "buildYear": 2023,
        "images": [
            {
                "thumbnail": "https://ireland.apollo.olxcdn.com/v1/files/\u2026/image;s=184x138;q=80"
            }
        ]
    },
    "meta": {
        "endpoint_family": "listing",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | Error | The requested Imovirtual resource was not found. Not billed. |
|  | Error | Imovirtual could not be reached. Not billed. |
|  | Error | Imovirtual rejected the request. Not billed. |
|  | Error | The upstream service is temporarily unavailable. Please retry shortly. |
|  | Error | Imovirtual returned an unexpected payload shape. 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)