# Trade-A-Plane Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/trade/a-plane-search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/trade-a-plane-search |

## Description

Extract detailed aircraft data from Trade-A-Plane to enhance aviation insights and automate decision-making.

## 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/trade/a-plane-search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Example

```json
{
  "aircraftList": [
    {
      "link": "https://www.trade-a-plane.com/search?s-type=aircraft&global-express",
      "price": "Inquire",
      "title": "2000 Bombardier Global Express",
      "images": [
        "https://images.trade-a-plane.com/aircraft/2000-bombardier-global-express-1.jpg",
        "https://images.trade-a-plane.com/aircraft/2000-bombardier-global-express-2.jpg"
      ],
      "location": "Los Angeles, CA USA",
      "specifications": {
        "year": "2000",
        "totalTime": "7800",
        "registration": "N671AJ",
        "serialNumber": "9015"
      }
    },
    {
      "link": "https://www.trade-a-plane.com/search?s-type=aircraft&challenger-300",
      "price": "$9,750,000",
      "title": "2011 Bombardier Challenger 300",
      "images": [
        "https://images.trade-a-plane.com/aircraft/2011-bombardier-challenger-300-1.jpg",
        "https://images.trade-a-plane.com/aircraft/2011-bombardier-challenger-300-2.jpg"
      ],
      "location": "Fort Lauderdale, FL USA",
      "specifications": {
        "year": "2011",
        "totalTime": "3456",
        "registration": "N750JE",
        "serialNumber": "CH300-202"
      }
    }
  ],
  "totalResults": 25
}
```

## Documentation

## Overview
Extract detailed aircraft data from Trade-A-Plane to enhance aviation insights and automate decision-making.

## Quickstart
```
GET https://api.piloterr.com/v2/trade/a-plane-search?query=example
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Search query or target identifier |

## Main use cases
- Integrate Trade-A-Plane Search data into enrichment, analytics, and monitoring pipelines
- Automate large-scale extraction from Trade without maintaining scrapers
- Power internal dashboards and workflow automations with live Trade data