Skip to content
Scrappa Get API key
Bring a Trailer API 1 credit/request

Bring a Trailer Listing API Documentation

GET https://scrappa.co/api/bring-a-trailer/v1/listings/{id}?id=120648745

Retrieve the full detail record of one Bring a Trailer auction by ID or slug: title, year, make, model, era, origin, category, location, the typed essentials (location, chassis/VIN where public, mileage with unit, engine, transmission, colors, wheels, other equipment, seller), the lot number, the seller type, the bid with current amount, count and end time as ISO 8601 UTC, views, watchers, comments count, gallery images with large and small variants, the closing history event with buyer and seller usernames, the buyer fees and the reserve state.

Bring a Trailer Listing API Documentation 1 credit/request

Endpoint

Request preview
GET
https://scrappa.co/api/bring-a-trailer/v1/listings/{id}?id=120648745
Auth header
x-api-key
Cost
1 credit/request
id = 120648745
Response preview
200 OK
{
    "success": true,
    "data": {
        "listing": {
            "id": 120648745,
            "title": "5k-Mile 2016 Ferrari 488 Spider",
            "year": 2016,
            "make": "Ferrari",
            "model": "Ferrari 488",
            "era": "2010s",
            "origin": "Italian",
            "category": "Convertibles",
            "location_country": "Located in United States",
            "essentials": {
...

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

1 required parameter needed before sending a request.

id string Required

Listing ID from the search endpoint, e.g. 120648745, or the listing slug.

Example value 120648745

Request Examples

PHP
<?php

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => "https://scrappa.co/api/bring-a-trailer/v1/listings/{id}?id=120648745",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => [
        "x-api-key: YOUR_API_KEY_HERE"
    ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
    echo "cURL Error #:" . $err;
} else {
    echo $response;
}
PHP
<?php

use Illuminate\Support\Facades\Http;

$response = Http::timeout(30)
    ->withHeaders(['x-api-key' => 'YOUR_API_KEY_HERE'])
    ->get('https://scrappa.co/api/bring-a-trailer/v1/listings/{id}?id=120648745');

if ($response->successful()) {
    echo $response->body();
} else {
    echo "Error: " . $response->status();
}
JavaScript
const options = {
    method: 'GET',
    headers: {
        'x-api-key': 'YOUR_API_KEY_HERE'
    }
};

fetch('https://scrappa.co/api/bring-a-trailer/v1/listings/{id}?id=120648745', options)
    .then(response => {
        if (!response.ok) {
            throw new Error(`HTTP error! status: ${response.status}`);
        }
        return response.text();
    })
    .then(data => console.log(data))
    .catch(error => console.error('Error:', error));
JavaScript
const axios = require('axios');

const options = {
    method: 'GET',
    url: 'https://scrappa.co/api/bring-a-trailer/v1/listings/{id}?id=120648745',
    headers: {
        x-api-key: 'YOUR_API_KEY_HERE',
    }
};

try {
    const response = await axios(options);
    console.log(response.data);
} catch (error) {
    console.error('Error:', error.message);
}
Ruby
require 'net/http'
require 'uri'

uri = URI.parse("https://scrappa.co/api/bring-a-trailer/v1/listings/{id}?id=120648745")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == 'https'

request = Net::HTTP::Get.new(uri.request_uri)
request['x-api-key'] = 'YOUR_API_KEY_HERE'

begin
    response = http.request(request)
    puts response.body
rescue => e
    puts "Error: #{e.message}"
end
Python
import http.client
import json

conn = http.client.HTTPSConnection("scrappa.co")

headers = {
    'x-api-key': 'YOUR_API_KEY_HERE',
}

try:
    conn.request("GET", "/api/bring-a-trailer/v1/listings/{id}?id=120648745", headers=headers)
    res = conn.getresponse()
    data = res.read()
    print(data.decode("utf-8"))
except Exception as e:
    print(f"Error: {e}")
finally:
    conn.close()
Python
import requests

headers = {
    'x-api-key': 'YOUR_API_KEY_HERE',
}

try:
    response = requests.get('https://scrappa.co/api/bring-a-trailer/v1/listings/{id}?id=120648745', headers=headers)
    response.raise_for_status()
    print(response.text)
except requests.exceptions.RequestException as e:
    print(f"Error: {e}")
Java
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;
import java.io.IOException;

public class ApiExample {
    public static void main(String[] args) {
        OkHttpClient client = new OkHttpClient();

        Request request = new Request.Builder()
            .url("https://scrappa.co/api/bring-a-trailer/v1/listings/{id}?id=120648745")
        .addHeader("x-api-key", "YOUR_API_KEY_HERE")
            .build();

        try (Response response = client.newCall(request).execute()) {
            if (response.isSuccessful()) {
                System.out.println(response.body().string());
            } else {
                System.out.println("Error: " + response.code());
            }
        } catch (IOException e) {
            System.out.println("Error: " + e.getMessage());
        }
    }
}
Go
package main

import (
    "fmt"
    "net/http"
    "io/ioutil"
)

func main() {
    client := &http.Client{}
    req, err := http.NewRequest("GET", "https://scrappa.co/api/bring-a-trailer/v1/listings/{id}?id=120648745", nil)
    if err != nil {
        fmt.Println("Error creating request:", err)
        return
    }
    req.Header.Set("x-api-key", "YOUR_API_KEY_HERE")

    resp, err := client.Do(req)
    if err != nil {
        fmt.Println("Error making request:", err)
        return
    }
    defer resp.Body.Close()

    body, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        fmt.Println("Error reading response:", err)
        return
    }

    fmt.Println(string(body))
}
Terminal
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/bring-a-trailer/v1/listings/{id}?id=120648745"
C#
using System;
using System.Net.Http;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        using var client = new HttpClient();
        client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY_HERE");

        try
        {
            var response = await client.SendAsync(new HttpRequestMessage(HttpMethod.Get, "https://scrappa.co/api/bring-a-trailer/v1/listings/{id}?id=120648745"));
            var content = await response.Content.ReadAsStringAsync();
            Console.WriteLine(content);
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
    }
}
TypeScript
import axios from 'axios';

async function run(): Promise<void> {
    try {
        const response = await axios({
            method: 'GET',
            url: 'https://scrappa.co/api/bring-a-trailer/v1/listings/{id}?id=120648745',
            headers: {
        'x-api-key': 'YOUR_API_KEY_HERE',
            },
        });

        console.log(response.data);
    } catch (error) {
        console.error('Error:', error);
    }
}

void run();
RUST
use reqwest::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();

    let response = client
        .get("https://scrappa.co/api/bring-a-trailer/v1/listings/{id}?id=120648745")
        .header("x-api-key", "YOUR_API_KEY_HERE")
        .send()
        .await?;

    println!("{}", response.text().await?);

    Ok(())
}

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

success data meta
JSON Response
200 OK
{
    "success": true,
    "data": {
        "listing": {
            "id": 120648745,
            "title": "5k-Mile 2016 Ferrari 488 Spider",
            "year": 2016,
            "make": "Ferrari",
            "model": "Ferrari 488",
            "era": "2010s",
            "origin": "Italian",
            "category": "Convertibles",
            "location_country": "Located in United States",
            "essentials": {
                "location": "Lincoln, Nebraska 68512",
                "chassis": "ZFF80AMA2G0218545",
                "mileage": {
                    "value": 5000,
                    "unit": "mi"
                },
                "engine": "Twin-Turbocharged 3.9-Liter V8",
                "transmission": "Seven-Speed F1 Dual-Clutch Automatic Transaxle",
                "exterior_color": "Rosso Corsa Paint",
                "interior_color": "Beige Tradizione Leather Upholstery",
                "wheels": "20\" Split-Spoke Alloy Wheels",
                "other": [
                    "Scuderia Ferrari Fender Shields",
                    "Power-Retractable Hardtop",
                    "Parking Sensors",
                    "Power-Adjustable Daytona-Style Seats",
                    "JBL Sound System",
                    "Window Sticker",
                    "Service Records"
                ],
                "seller": "Private Party"
            },
            "lot": "#267872",
            "seller_type": "private",
            "bid": {
                "current": 180000,
                "count": 13,
                "ends_at": "2026-10-12T17:00:00+00:00"
            },
            "comments_count": 14,
            "images": [
                {
                    "id": 120583767,
                    "title": "5k-Mile 2016 Ferrari 488 Spider",
                    "large": {
                        "url": "https://bringatrailer.com/wp-content/uploads/2026/08/IMG_4251-scaled-65019.jpeg",
                        "width": 2048,
                        "height": 1536
                    },
                    "small": {
                        "url": "https://bringatrailer.com/wp-content/uploads/2026/08/IMG_4251-scaled-65019.jpeg?w=155&h=105&crop=1",
                        "width": 155,
                        "height": 105
                    }
                }
            ],
            "history": [],
            "fees": {
                "buyer_fee_percentage": 5,
                "buyer_fee_minimum": 250,
                "buyer_fee_maximum": 7500
            },
            "reserve": {
                "has_reserve": true,
                "reserve": null,
                "rnm_status": "not-started"
            },
            "permalink": "https://bringatrailer.com/listing/2016-ferrari-488-spider-14/",
            "post_status": "active"
        }
    },
    "meta": {
        "endpoint_family": "listing"
    }
}

Errors

Handle these documented responses before retrying or showing customer-facing failures.

422

HTTP 422

A public parameter is invalid. This response is not billable.

404

HTTP 404

Bring a Trailer rejected the request. This response is not billable.

502

HTTP 502

Bring a Trailer returned an unexpected response. This response is not billable.

503

HTTP 503

Bring a Trailer did not return usable data for this request. This response is not billable.

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Try It Live

Test this endpoint in our interactive playground with real data.