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.
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
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.
| 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. |
| 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 |
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.
- Scan pistons, turbines, or a model name
- Page a make such as Cessna or Piper
- Take a listing URL into the listing call
| 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