# coches.net Listing

Returns the detail record for one listing, addressed by its full path. Take the url entry that comes back from /search and pass it as path — the absolute url and its bare path are both accepted, so no URL is ever guessed. There is deliberately no id-only form: the path is semantic and per listing, so an assembled URL 404s for listings that exist, and an id is refused with a 422 rather than forwarded. The response carries the vehicle specifications, equipment, price rating with market average, photos, related ads and the seller block without contact data.

- **Documentation:** [https://scrappa.co/docs/coches-net-api/coches_net_listing](https://scrappa.co/docs/coches-net-api/coches_net_listing)
- **API group:** coches.net API
- **Endpoint:** `GET https://scrappa.co/api/coches-net/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 |
| --- | --- | --- | --- |
| `path` | string | Yes | The url value from a search item, absolute or just its path, for example https://www.coches.net/mg-hs-15-turbo-gdi-comfort-5p-gasolina-2024-en-a_coruna-71617238-covo.aspx. Required. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/coches-net/listing?path=%2Fmg-hs-15-turbo-gdi-comfort-5p-gasolina-2024-en-a_coruna-71617238-covo.aspx"
```

## Example response

```json
{
    "success": true,
    "data": {
        "id": "71617238",
        "title": "MG HS 1.5 Turbo GDI Comfort",
        "url": "https://www.coches.net/mg-hs-15-turbo-gdi-comfort-5p-gasolina-2024-en-a_coruna-71617238-covo.aspx",
        "price": {
            "amount": 16000,
            "currency": "EUR"
        },
        "mileage": {
            "value": 66193,
            "unit": "km"
        },
        "first_registration": {
            "year": 2024
        },
        "power": {
            "value": 160,
            "unit": "hp"
        },
        "make": {
            "id": 31,
            "label": "MG"
        },
        "model": {
            "id": 1362,
            "label": "HS"
        },
        "fuel": {
            "id": 2,
            "label": "Gasolina"
        },
        "plate_registration_date": "05/2024",
        "vehicle_specifications": {
            "body_type": "SUV",
            "cubic_capacity": {
                "value": 1490,
                "unit": "cc"
            },
            "doors": 5,
            "seats": 5,
            "power": {
                "value": 160,
                "unit": "hp"
            },
            "version": "1.5 Turbo GDI Comfort"
        },
        "equipment": {
            "standard": [],
            "optional": []
        },
        "price_rating": {
            "rank_indicator": 3,
            "market_average": {
                "amount": 15300,
                "currency": "EUR"
            },
            "drop": null,
            "show_price_indicator": true
        },
        "seller": {
            "is_dealer": true,
            "is_private": false,
            "dealer": {
                "id": 130471,
                "name": "Crestanevada Madrid"
            }
        }
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | The requested listing or dealer was not found. This response is not billable. |
| 422 | Validation Error | A public parameter is invalid, including a listing path that is not a coches.net listing url. This response is not billable. |
| 503 | Service Unavailable | The service could not obtain a complete result from coches.net. 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)