Skip to main content
Piloterr
Back to library

Trade-A-Plane Search API

Search Trade-A-Plane aircraft listings by keyword and page the results. Cards include title, price, and the listing link.

Active2 credits = 1 requestGET/v2/tradeaplane/search

Endpoint Overview

Detailed documentation, pricing, and usage examples.

OverviewLink to 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.

QuickstartLink to 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

queryLink to 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.

ParametersLink to 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 fieldsLink to 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

NotesLink to 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 casesLink to 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 codesLink to 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

Trade-A-Plane Listing

Related APIs

Expand your data capabilities with these complementary tools.

Ready to get started?

Your web scraping API is one click away. Start with +500 credits, no infrastructure to set up, no proxies to manage, and no credit card required.

  • +500 credits
  • No credit card required
  • All endpoints included