Trade-A-Plane listing page.
query is a listing URL. It contains listing_id and s-type (aircraft or engine). The response is one flat object: price, seller, phone, location, description, photos and specifications.
A search URL without listing_id returns 400.
GET https://api.piloterr.com/v2/tradeaplane/listing?query=https://www.trade-a-plane.com/search?category_level1=Piston+Engine&make=ROLLS+ROYCE&model=PACKARD+V-1650&listing_id=2419556&s-type=engine
Example (listing 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
query is required. Only www.trade-a-plane.com is accepted.
| Form |
Example |
What happens |
| Listing 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 |
Opens that listing. The query must include listing_id. |
A search URL without listing_id returns 400. Another host returns 400. An empty value returns 400.
| Parameter |
Type |
Required |
Description |
query |
string |
yes |
Listing URL that includes listing_id |
| Field |
Type |
Description |
listing_id |
string |
Listing id |
title |
string |
Listing title |
url |
string |
Listing URL |
listing_type |
string | null |
aircraft or engine |
category |
string | null |
Category |
make |
string | null |
Make |
model |
string | null |
Model |
sale_status |
string | null |
For Sale or similar |
condition |
string | null |
Condition |
price |
number | null |
Price in USD |
price_display |
string | null |
Price as shown |
price_note |
string | null |
Extra price line |
currency |
string | null |
USD |
seller |
string | null |
Seller |
phone |
string | null |
Seller phone |
city |
string | null |
City |
region |
string | null |
State |
country |
string | null |
Country |
postal_code |
string | null |
Postal code |
description |
string | null |
Detailed description |
images |
string[] |
Gallery URLs |
specifications |
array |
Rows { name, value } |
price_note is the extra price line, such as OBO Will Consider All Trades.
images are the listing gallery. The same photo is returned once.
specifications are the label/value rows on the page.
warranty is null when the page says Not Listed.
- Open the aircraft a search card pointed to
- Store total time, year, and price
- Keep the seller contact fields that the page shows
| Code |
Meaning |
400 |
Empty query, unknown host, or a search URL without listing_id |
403 |
Blocked |
404 |
Listing not found |
500 |
Fetch failed |
Trade-A-Plane Search