# Milanuncios Listing API Documentation

Returns the full record for one ad, addressed by the numeric id from a search result: complete description, typed attributes (for example kilometers and year as integers), category path, location, seller type, publication time and every photo. Seller identity and contact data are not returned. Ads expire; an unknown or expired id answers a 404 with error.code NOT_FOUND, which is not billable.

- **Documentation:** [https://scrappa.co/docs/milanuncios-api/milanuncios_listing](https://scrappa.co/docs/milanuncios-api/milanuncios_listing)
- **API group:** Milanuncios API
- **Endpoint:** `GET https://scrappa.co/api/milanuncios/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 | Numeric ad id from a search result, for example 619944920. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/milanuncios/listing?id=619944920"
```

## Example response

```json
{
    "success": true,
    "data": {
        "listing": {
            "id": "619944920",
            "title": "BMW Serie 1 120",
            "url": "https://www.milanuncios.com/bmw-de-segunda-mano/bmw-serie-1-120-619944920.htm",
            "category_ids": [
                1,
                13,
                805
            ],
            "category_names": [
                "Motor",
                "Coches",
                "BMW"
            ],
            "price": {
                "value": 34300,
                "label": "34.300 \u20ac"
            },
            "attributes": {
                "color": "Gris",
                "doors": 5,
                "environmentalLabel": "ECO",
                "fuel": "hybrid",
                "hp": 170,
                "kilometers": 19000,
                "transmission": "AUTOMATIC",
                "warranty": "24 meses (2 a\u00f1os)",
                "year": 2026
            },
            "location": {
                "city": "Arroyo de la Miel",
                "province": "M\u00e1laga",
                "region": "Andaluc\u00eda"
            },
            "seller_type": "professional",
            "published_at": "2026-10-15T15:28:42Z",
            "images": [
                "https://images.milanuncios.com/api/v1/ma-ad-media-pro/images/aa9c94ac-bf64-42c8-9c50-821b9a8046fe?rule=original"
            ]
        }
    },
    "meta": {
        "endpoint_family": "listing",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | The requested ad or car make was not found or has expired. This response is not billable. |
| 422 | Validation Error | A parameter is invalid, including a sort newest or oldest on a real estate category or an offset + limit above 10000. This response is not billable. |
| 503 | Service Unavailable | The service could not obtain a complete result from Milanuncios. 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)