# Copart Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/copart/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 2 credits per call |
| **Documentation** | https://www.piloterr.com/library/copart-search |

## Description

Copart Search API: search auction lots by keyword or URL across Copart regional sites. Returns lot listings and pagination.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/copart/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search chevrolet on copart.com (page 1)

```json
{
  "results": [
    {
      "id": "99998285",
      "url": "https://www.copart.com/lot/99998285/2018-chevrolet-volt-lt-ky-walton",
      "title": "Lot Details",
      "region": "www.copart.com",
      "image_url": "https://cs.copart.com/v1/AUTH_svc.pdoc00001/lpp/0126/c52d88ab17584eef8aaeec778bfd0cf7_thb.jpg"
    },
    {
      "id": "99997735",
      "url": "https://www.copart.com/lot/99997735/2017-chevrolet-silverado-k1500-high-country-ky-louisville",
      "title": "Lot Details",
      "region": "www.copart.com",
      "image_url": "https://cs.copart.com/v1/AUTH_svc.pdoc00001/lpp/0126/24b81615824643148af9cd947ab96c3c_thb.jpg"
    },
    {
      "id": "99997465",
      "url": "https://www.copart.com/lot/99997465/2020-transcraft-drop-deck-trailer-va-richmond",
      "title": "Lot Details",
      "region": "www.copart.com",
      "image_url": "https://cs.copart.com/v1/AUTH_svc.pdoc00001/lpp/0126/1d92611531ed43c89a846d17fd7a0e87_thb.jpg"
    }
  ],
  "pagination": {
    "next": "https://www.copart.com/lotSearchResults?free=true&query=chevrolet&page=2",
    "page": 1,
    "region": "www.copart.com",
    "keyword": "chevrolet",
    "per_page": 20,
    "total_pages": 500,
    "total_results": 10000
  }
}
```

## Documentation

## Overview
Search salvage and used vehicles on [Copart](https://www.copart.com). Pass a **keyword** or a **full search URL**, optionally with **`region`**, and get a list of matching lots with links, thumbnails, and pagination.

Use **Copart Lot** on any result `id` or `url` for full vehicle details.

## Supported regions
| Code | Site | Currency |
|---|---|---|
| `us` (default) | www.copart.com | USD |
| `ca` | www.copart.ca | CAD |
| `uk` | www.copart.co.uk | GBP |
| `ie` | www.copart.ie | EUR |
| `mea` / `ae` / `bh` / `om` | www.copartmea.com | AED |
| `de` | www.copart.de | EUR |
| `es` | www.copart.es | EUR |
| `fi` | www.copart.fi | EUR |
| `br` | www.copart.com.br | BRL |

## Quickstart
```
GET https://api.piloterr.com/v2/copart/search?query=chevrolet
GET https://api.piloterr.com/v2/copart/search?query=audi&region=ca
GET https://api.piloterr.com/v2/copart/search?query=https://www.copart.co.uk/lotSearchResults?query=bmw
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Keyword or full Copart search URL |
| `region` | string | no | Region code when `query` is a keyword only (default: US) |
| `page` | integer | no | Page number (default: 1) |
| `return_page_source` | boolean | no | Raw HTML instead of JSON (default: `false`) |

## Response
Returns `results[]` (lot summaries with `id`, `title`, `url`, `image_url`, `region`) and `pagination` (`page`, `per_page`, `total_results`, `total_pages`, `next`, `keyword`, `region`).

## Copart workflow
1. **Copart Search**: find lots (this endpoint)
2. **Copart Lot**: full lot page data

Costs **2 credits** per call.