# Autovit & Standvirtual Listing API Documentation

Scrappa's `GET /api/{platform}/listing` endpoint returns the full detail of a single vehicle listing from Autovit.ro or Standvirtual.com as JSON.

## What the response contains

The listing carries `id`, `url`, `title`, `status`, `description`, `price` (numeric value + currency), `price_evaluation`, `make`, `model`, `year`, `mileage`, `engine_power`, `engine_capacity`, `fuel`, `transmission`, `body_type`, `vin`, `first_registration`, `location` (address, city, region, country, postal code, coordinates), `images`, `equipment` (grouped items), `parameters` (every parameter with value and unit) and the public `seller` block. Seller phone numbers are never returned.

## Correctness notes

Both platforms answer an unknown listing id with a well-formed 404. This endpoint maps that to a `NOT_FOUND` error and never bills it.

## Related endpoints

- `GET /api/{platform}/search` — find the listing id first
- `GET /api/{platform}/dealer` — the dealer profile behind a listing's `seller.url`

- **Documentation:** [https://scrappa.co/docs/autovit-standvirtual-api/autovit_listing](https://scrappa.co/docs/autovit-standvirtual-api/autovit_listing)
- **API group:** Autovit & Standvirtual API
- **Endpoint:** `GET https://scrappa.co/api/autovit/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 |
| --- | --- | --- | --- |
| `listing_id` | string | Yes | Numeric listing id, as returned in the search response. |
| `url` | string | No | Full detail URL from a search card. Alternative to listing_id. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/autovit/listing?listing_id=7060486207"
```

## Example response

```json
{
    "success": true,
    "data": {
        "listing": {
            "id": "7060486207",
            "url": "https://www.autovit.ro/autoturisme/anunt/bmw-x6-ver-xdrive40i-at-mhev-ID7HP4ZN.html",
            "title": "BMW X6 xDrive40i AT MHEV",
            "status": "ACTIVE",
            "price": {
                "value": 59900,
                "currency": "EUR",
                "is_under_budget": false
            },
            "make": "bmw",
            "model": "x6",
            "year": 2023,
            "mileage": 15000,
            "engine_power": 381,
            "engine_capacity": 2998,
            "fuel": "hibrid",
            "transmission": "automat",
            "body_type": "suv",
            "first_registration": "2023",
            "location": {
                "city": "Bucuresti",
                "city_id": 123,
                "country": "Romania"
            },
            "images": [
                "https://autovit.ro/placeholder.jpg"
            ],
            "equipment": [
                {
                    "group": "Confort",
                    "items": [
                        "Aer conditionat",
                        "Scaune calduze"
                    ]
                }
            ],
            "parameters": [
                {
                    "key": "mileage",
                    "value": 15000,
                    "unit": "km"
                }
            ],
            "seller": {
                "type": "PROFESSIONAL",
                "name": "LUXURY MOTORS BUCURESTI",
                "url": "https://luxurymotors.autovit.ro/inventory"
            }
        }
    },
    "meta": {
        "endpoint_family": "listing"
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | Error | No listing carries that id. Not billed. |
|  | Error | The platform could not be reached. Not billed. |
|  | Error | The upstream service is temporarily unavailable. Please retry shortly. |

## Frequently asked questions

### Where do I get a listing id?

From the `id` field of any item returned by the search endpoint.

### What happens for an id that does not exist?

You get a NOT_FOUND error rather than a broken page, and the request is not billed.

### Do I get the seller phone number?

No. Seller phone numbers are removed before the response leaves the service.

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