# Trade-A-Plane Search ## Overview | Property | Value | |----------|-------| | **Status** | active | | **Method** | `GET` | | **Endpoint** | `/v2/tradeaplane/search` | | **Base URL** | `https://api.piloterr.com` | | **Credit Cost** | 2 credits per call | | **Documentation** | https://www.piloterr.com/library/tradeaplane-search | ## Description Search Trade-A-Plane aircraft listings by keyword and page the results. Cards include title, price, and the listing link. ## 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/tradeaplane/search' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' ``` ## Example Response ### rol engines ```json { "results": [ { "url": "https://www.trade-a-plane.com/search?category_level1=Piston+Engine&make=ROLLS+ROYCE&model=PACKARD+V-1650&listing_id=2419556&s-type=engine", "city": "Spring", "make": "ROLLS ROYCE", "year": null, "image": "https://dsgiipnwy1jd8.cloudfront.net/eyJlZGl0cyI6eyJzbWFydE92ZXJsYXkiOnsiYnVja2V0IjoidGFwLWFzc2V0czEiLCJrZXkiOiJ3YXRlcm1hcmsucG5nIn0sInJlc2l6ZSI6eyJmaXQiOiJjb250YWluIiwiYmFja2dyb3VuZCI6eyJhbHBoYSI6MSwiYiI6MjU1LCJyIjoyNTUsImciOjI1NX0sIndpZHRoIjozMDB9fSwia2V5IjoiMTEwMjY0OC5qcGciLCJidWNrZXQiOiJ0YXAtYXNzZXRzMSJ9", "model": "PACKARD V-1650", "phone": "(281) 467-4348", "price": 61750, "title": "ROLLS ROYCE PACKARD V-1650 (For Sale)", "region": "TX", "seller": "Terry Sonday", "country": "USA", "summary": "Set of -9 heads and banks on transport plates, Going to be having them refreshed at a maintenance shop of your choice, $61,750. These also come with an ext...", "category": "Piston Engine", "currency": "USD", "position": 1, "condition": "Overhauled", "listing_id": "2419556", "total_time": null, "updated_at": "08/25/2023", "listing_type": "engine", "registration": null, "price_display": "$61,750" }, { "url": "https://www.trade-a-plane.com/search?category_level1=Turbine+Engine&make=ALLISON&model=250-B17F&listing_id=2456631&s-type=engine", "city": "Moodus", "make": "ALLISON", "year": null, "image": "/display-asset?asset_id=1&width=300", "model": "250-B17F", "phone": null, "price": 500000, "title": "ALLISON 250-B17F (For Sale)", "region": "CT", "seller": "Colleen Pollard", "country": "USA", "summary": "The Rolls-Royce (Allison) 250-B17F/2 is a lightweight, highly reliable turboprop engine delivering 450 shaft-horsepower (shp). Part of the renowned M250 fa...", "category": "Turbine Engine", "currency": "USD", "position": 2, "condition": "New", "listing_id": "2456631", "total_time": null, "updated_at": "10/17/2026", "listing_type": "engine", "registration": null, "price_display": "$500,000" } ], "pagination": { "next": null, "page": 1, "per_page": 5, "total_pages": 1, "total_results": 5 } } ``` ## Documentation ## Overview **Trade-A-Plane** search for aircraft and engines. `query` is a keyword or a `/filtered/search` or `/search` URL. With a keyword, `listing_type` is `aircraft` or `engine`. The response is `{ results, pagination }`. A URL that already contains `listing_id` returns `400`. ## Quickstart ``` GET https://api.piloterr.com/v2/tradeaplane/search?query=rol&listing_type=engine GET https://api.piloterr.com/v2/tradeaplane/search?query=spirit&listing_type=aircraft GET https://api.piloterr.com/v2/tradeaplane/search?query=https://www.trade-a-plane.com/filtered/search?s-type=engine&s-keyword-search=rol&s-original-search=rol ``` ## `query` **Example (engine keyword):** rol **Example (aircraft keyword):** spirit **Example (search URL):** https://www.trade-a-plane.com/filtered/search?s-type=aircraft&s-keyword-search=spirit&s-original-search=spirit `query` is required. Only `www.trade-a-plane.com` is accepted. | Form | Example | What happens | |---|---|---| | Keyword, engines | `rol` + `listing_type=engine` | Builds `/filtered/search?s-type=engine&s-keyword-search=rol`. | | Keyword, aircraft | `spirit` + `listing_type=aircraft` | Builds `/filtered/search?s-type=aircraft&s-keyword-search=spirit`. | | Search URL | `https://www.trade-a-plane.com/filtered/search?s-type=engine&s-keyword-search=rol&s-original-search=rol` | Uses that search. `page` is sent as `s-page`. | A listing URL returns `400`. A keyword without `listing_type` returns `400`. Another host returns `400`. `page` below 1 returns `400`. `page` starts at 1. Page 2 is `s-page=2` on the same search. ## Parameters | Parameter | Type | Required | Description | |---|---|---|---| | `query` | string | yes | Keyword, or a `/filtered/search` or `/search` URL without `listing_id` | | `listing_type` | string | no | `aircraft` or `engine` when `query` is a keyword. Ignored when `query` is a URL. | | `page` | integer | no | Page from 1. Sent as `s-page`. | ## Response fields | Field | Type | Description | |---|---|---| | `results[].listing_id` | string | Listing id | | `results[].title` | string | Card title | | `results[].url` | string | Listing URL | | `results[].listing_type` | string | `aircraft` or `engine` | | `results[].category` | string \| null | Category | | `results[].year` | integer \| null | Year when the title starts with one | | `results[].make` | string \| null | Make | | `results[].model` | string \| null | Model | | `results[].price` | number \| null | Price in USD. Null for Call for Price | | `results[].price_display` | string \| null | Price as shown | | `results[].currency` | string \| null | `USD` when a price is present | | `results[].condition` | string \| null | Engine condition | | `results[].registration` | string \| null | Aircraft registration | | `results[].total_time` | string \| null | Total time | | `results[].seller` | string \| null | Seller name | | `results[].city` | string \| null | City | | `results[].region` | string \| null | State | | `results[].country` | string \| null | Country | | `results[].phone` | string \| null | Seller phone | | `pagination.total_results` | integer \| null | Result count from the heading | | `pagination.next` | string \| null | Next page URL | ## Notes `price` is a number in USD. `price_display` is the text on the card, including `Call for Price` when no amount is shown. `condition` is set for engines. `registration` is set for aircraft (`Reg#`). `total_time` is null when the card says `Not Listed`. `phone` is the seller number from the listing. `total_results` comes from `Showing 1 - N of M results`. ## Main use cases - Scan pistons, turbines, or a model name - Page a make such as Cessna or Piper - Take a listing URL into the listing call ## Error codes | Code | Meaning | |---|---| | `400` | Empty query, missing listing_type, unknown host, or a listing URL | | `403` | Blocked | | `404` | No listing on the page | | `500` | Fetch failed | ## Related endpoints [Trade-A-Plane Listing](https://www.piloterr.com/library/tradeaplane-listing)