# AutoTrader.ca Listing Detail API Documentation

Fetch one public AutoTrader.ca car listing by id: title, description as plain text, price in CAD with its market rating, vehicle make, model, year, mileage, transmission, fuel, drivetrain, body type, colour, doors, seats and equipment list, image urls, location with coordinates, the seller (dealer or private) with company name, website and phone numbers, the Carfax report url and the creation timestamp. An unknown id answers a non-billable 404.

- **Documentation:** [https://scrappa.co/docs/autotrader-ca-api/autotrader_ca_listing](https://scrappa.co/docs/autotrader-ca-api/autotrader_ca_listing)
- **API group:** AutoTrader.ca API
- **Endpoint:** `GET https://scrappa.co/api/autotrader_ca/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 | AutoTrader.ca listing UUID from a search result. Example: 13c8b0af-3d77-46cf-aa5a-e74290d5328d. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/autotrader_ca/listing?id=13c8b0af-3d77-46cf-aa5a-e74290d5328d"
```

## Example response

```json
{
    "success": true,
    "data": {
        "id": "13c8b0af-3d77-46cf-aa5a-e74290d5328d",
        "title": "2021 Honda Civic Sedan",
        "url": "https://www.autotrader.ca/offers/honda-civic-sedan-lx-cvt-apo-carplay-backup-cam-htd-seats-honda-sense-gasoline-black-cat_ma31gr200622va2411tr11703-13c8b0af-3d77-46cf-aa5a-e74290d5328d",
        "description": "2.0L I-4 DOHC 16-Valve i-VTEC Engine | Crystal Black Pearl | Black | FWD | 4 door | Sedan\n\nApple CarPlay/Android Auto smart device mirroring\nCollision Mitigation Braking System (CMBS) + FCW forward co\u2026",
        "price": 16999,
        "currency": "CAD",
        "price_evaluation": "great_price",
        "median_market_price": 18600,
        "created_at": "2026-10-02T07:10:14Z",
        "condition": "used",
        "vehicle": {
            "make": "Honda",
            "model": "Civic",
            "variant": "Civic Sedan",
            "trim": "Sedan LX CVT APO | CarPlay | Backup Cam | Htd Seats | Honda Sense",
            "year": 2021,
            "mileage_km": 131616,
            "transmission": "Automatic",
            "fuel": "Gasoline",
            "drivetrain": "Front Wheel Drive",
            "body_type": "Sedan",
            "body_color": "Black",
            "body_color_name": "Crystal Black Pearl",
            "doors": 4,
            "seats": 5,
            "cylinders": 4,
            "equipment": [
                "Air conditioning",
                "Automatic climate control",
                "Cruise control",
                "Power windows"
            ]
        },
        "images": [
            "https://prod.pictures.autoscout24.net/listing-images/13c8b0af-3d77-46cf-aa5a-e74290d5328d_947a8ded-63f0-48c0-948f-c376b2c7df81.jpg/1280x960.webp?promo=ae1d4f1e-637d-4565-aeec-0666f480e40d_2",
            "https://prod.pictures.autoscout24.net/listing-images/13c8b0af-3d77-46cf-aa5a-e74290d5328d_6e203296-d018-4ae7-8eb5-09a155c5b7f7.jpg/1280x960.webp"
        ],
        "video_url": "https://www.youtube.com/watch?v=RlQ4CaNqNpY",
        "location": {
            "city": "MARKHAM",
            "province": "ON",
            "postal_code": "L3R 5X3",
            "street": "8220 KENNEDY RD",
            "latitude": 43.85487,
            "longitude": -79.30679
        },
        "seller": {
            "id": "47944480",
            "type": "dealer",
            "is_dealer": true,
            "company_name": "MARKHAM HONDA",
            "website": "https://www.markhamhonda.com/",
            "logo_url": "https://prod.pictures.autoscout24.net/dealer-info/47944480-original-f91c6097-3a5c-44dc-a2e4-d6bdcaeae01d.jpg/resize/200x100%3E/quality/90",
            "google_rating": 4.2,
            "phones": [
                {
                    "type": "office",
                    "number": "647-946-8441"
                },
                {
                    "type": "sms",
                    "number": "647-691-5347"
                }
            ]
        },
        "carfax_url": "https://vhr.carfax.ca/?id=aZrBl9Pw7SkiHVAf4y34GqmCFtrOFpJs"
    },
    "meta": {
        "endpoint_family": "listing",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | The id parameter is missing or not a listing UUID. This response is not billable. |
| 404 | Listing Not Found | No listing exists for the supplied id, or it was sold and removed. This response is not billable. |
| 503 | Upstream Unavailable | AutoTrader.ca is temporarily unreachable, blocked the request, or answered a shape we could not parse. Retry later; 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)