The Piloterr Trade-A-Plane Scraper API lets you extract public data from Trade-A-Plane as clean, structured JSON — no proxies, headless browsers or HTML parsing to maintain. Endpoints available in production:
- Trade-A-Plane Listing API — Read one Trade-A-Plane aircraft listing from its URL.
- Trade-A-Plane Search API — Search Trade-A-Plane aircraft listings by keyword and page the results.
Use it for listing monitoring, price benchmarks, stock sourcing or market analytics on second-hand and vehicle marketplaces.
| Endpoint | Path | Credits | What you get |
|---|---|---|---|
| Trade-A-Plane Listing API | /v2/tradeaplane/listing |
2 | Read one Trade-A-Plane aircraft listing from its URL. You get the asking price, the airframe details, and the seller. |
| Trade-A-Plane Search API | /v2/tradeaplane/search |
2 | Search Trade-A-Plane aircraft listings by keyword and page the results. Cards include title, price, and the listing link. |
- How it works
- Trade-A-Plane Listing API
- Trade-A-Plane Search API
- Code examples in other languages
- Practical use cases
- Why Piloterr?
- FAQ
- Official SDKs
- Related scrapers
- Support
- Create a free Piloterr account and copy your API key from the dashboard.
- Send a
GET(orPOST) request tohttps://api.piloterr.com/v2/...with the headerx-api-key: YOUR_API_KEY. - Receive structured JSON — Piloterr handles rendering, proxies, retries and parsing.
export PILOTERR_API_KEY="your-api-key"
pip install requests # Python
# TypeScript: Node.js 18+ (native fetch), run with `npx tsx file.ts`Every endpoint accepts both
GET(query string) andPOST(JSON body with the same fields).
Read one Trade-A-Plane aircraft listing from its URL. You get the asking price, the airframe details, and the seller.
GET | POST https://api.piloterr.com/v2/tradeaplane/listing · 2 credits per request · Full reference
| Parameter | Type | Required | Description |
|---|---|---|---|
query |
string | ✅ | Listing URL that includes listing_id. |
import json
import os
import requests
response = requests.get(
"https://api.piloterr.com/v2/tradeaplane/listing",
headers={"x-api-key": os.environ["PILOTERR_API_KEY"]},
params={
"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",
},
timeout=120,
)
response.raise_for_status()
data = response.json()
print(json.dumps(data, indent=2, ensure_ascii=False)[:2000])type TradeAPlaneListing = {
url?: string;
city?: string;
make?: string;
year?: unknown;
model?: string;
phone?: string;
price?: number;
title?: string;
images?: string[];
region?: string;
seller?: string;
country?: string;
category?: string;
currency?: string;
warranty?: unknown;
condition?: string;
listing_id?: string;
price_note?: string;
description?: string;
postal_code?: string;
sale_status?: string;
listing_type?: string;
price_display?: string;
specifications?: {
name?: string;
value?: string;
}[];
};
const params = new URLSearchParams({
"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",
});
const response = await fetch(`https://api.piloterr.com/v2/tradeaplane/listing?${params}`, {
headers: { "x-api-key": process.env.PILOTERR_API_KEY! },
});
if (!response.ok) throw new Error(`Piloterr error ${response.status}: ${await response.text()}`);
const data = (await response.json()) as TradeAPlaneListing;
console.log(JSON.stringify(data, null, 2).slice(0, 2000));POST variant
POST https://api.piloterr.com/v2/tradeaplane/listing
x-api-key: YOUR_API_KEY
Content-Type: application/json
{"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 response from the API reference, abridged — real values depend on the page you scrape.
{
"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,
"model": "PACKARD V-1650",
"phone": "example",
"price": 61750,
"title": "ROLLS ROYCE PACKARD V-1650",
"images": [
"https://dsgiipnwy1jd8.cloudfront.net/eyJrZXkiOiIxMTAyNjQ4LmpwZyIsImVkaXRzIjp7InJlc2l6ZSI6eyJmaXQiOiJjb250YWluIiwiYmFja2dyb3VuZCI6eyJyIjoy…",
"https://dsgiipnwy1jd8.cloudfront.net/eyJlZGl0cyI6eyJzbWFydE92ZXJsYXkiOnsia2V5Ijoid2F0ZXJtYXJrLnBuZyIsImJ1Y2tldCI6InRhcC1hc3NldHMxIn0sInJl…"
],
"region": "TX",
"seller": "example",
"country": "USA",
"category": "Piston Engine",
"currency": "USD",
"warranty": null,
"condition": "Overhauled",
"listing_id": "2419556",
"price_note": "OBO Will Consider All Trades",
"description": "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 als…",
"postal_code": "77379",
"sale_status": "For Sale",
"listing_type": "engine",
"price_display": "$61,750",
"specifications": [
{
"name": "Sale Status",
"value": "For Sale"
},
{
"name": "Category",
"value": "Piston Engine"
}
]
}| Field | Type | Description |
|---|---|---|
url |
string | |
city |
string | |
make |
string | |
year |
object | |
model |
string | |
phone |
string | |
price |
integer | |
title |
string | |
images |
string[] | |
region |
string | |
seller |
string | |
country |
string | |
category |
string | |
currency |
string | |
warranty |
object | |
condition |
string | |
listing_id |
string | |
price_note |
string | |
description |
string | |
postal_code |
string | |
sale_status |
string | |
listing_type |
string | |
price_display |
string | |
specifications[] |
object[] | |
specifications[].name |
string |
Search Trade-A-Plane aircraft listings by keyword and page the results. Cards include title, price, and the listing link.
GET | POST https://api.piloterr.com/v2/tradeaplane/search · 2 credits per request · Full reference
| Parameter | Type | Required | Description |
|---|---|---|---|
query |
string | ✅ | Keyword, or a Trade-A-Plane search URL without listing_id. |
listing_type |
string | — | aircraft or engine when query is a keyword. Ignored when query is a URL. |
page |
number | — | Page from 1. Sent as s-page. |
import json
import os
import requests
response = requests.get(
"https://api.piloterr.com/v2/tradeaplane/search",
headers={"x-api-key": os.environ["PILOTERR_API_KEY"]},
params={
"query": "rol",
},
timeout=120,
)
response.raise_for_status()
data = response.json()
print(json.dumps(data, indent=2, ensure_ascii=False)[:2000])type TradeAPlaneSearch = {
results?: {
url?: string;
city?: string;
make?: string;
year?: unknown;
image?: string;
model?: string;
phone?: string;
price?: number;
title?: string;
region?: string;
seller?: string;
country?: string;
summary?: string;
category?: string;
currency?: string;
position?: number;
condition?: string;
listing_id?: string;
total_time?: unknown;
updated_at?: string;
listing_type?: string;
registration?: unknown;
price_display?: string;
}[];
pagination?: {
next?: unknown;
page?: number;
per_page?: number;
total_pages?: number;
total_results?: number;
};
};
const params = new URLSearchParams({
"query": "rol",
});
const response = await fetch(`https://api.piloterr.com/v2/tradeaplane/search?${params}`, {
headers: { "x-api-key": process.env.PILOTERR_API_KEY! },
});
if (!response.ok) throw new Error(`Piloterr error ${response.status}: ${await response.text()}`);
const data = (await response.json()) as TradeAPlaneSearch;
console.log(JSON.stringify(data, null, 2).slice(0, 2000));POST variant
POST https://api.piloterr.com/v2/tradeaplane/search
x-api-key: YOUR_API_KEY
Content-Type: application/json
{"query": "rol"}Example response from the API reference, abridged — real values depend on the page you scrape.
{
"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/eyJlZGl0cyI6eyJzbWFydE92ZXJsYXkiOnsiYnVja2V0IjoidGFwLWFzc2V0czEiLCJrZXkiOiJ3YXRlcm1hcmsucG5nIn0sInJl…",
"model": "PACKARD V-1650",
"phone": "example",
"price": 61750,
"title": "ROLLS ROYCE PACKARD V-1650 (For Sale)",
"region": "TX",
"seller": "example",
"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 als…",
"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": "example",
"country": "USA",
"summary": "The Rolls-Royce (Allison) 250-B17F/2 is a lightweight, highly reliable turboprop engine delivering 450 shaft-horsepower (shp). Part of th…",
"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
}
}| Field | Type | Description |
|---|---|---|
results[] |
object[] | |
results[].url |
string | |
results[].city |
string | |
results[].make |
string | |
results[].year |
object | |
results[].image |
string | |
results[].model |
string | |
results[].phone |
string | |
results[].price |
integer | |
results[].title |
string | |
results[].region |
string | |
results[].seller |
string | |
results[].country |
string | |
results[].summary |
string | |
results[].category |
string | |
results[].currency |
string | |
results[].position |
integer | |
results[].condition |
string | |
results[].listing_id |
string | |
results[].total_time |
object | |
results[].updated_at |
string | |
results[].listing_type |
string | |
results[].registration |
object | |
results[].price_display |
string | |
pagination |
object |
Ready-to-run examples live in the examples/ folder. Each one reads your key from the PILOTERR_API_KEY environment variable.
| Language | Listing | Search |
|---|---|---|
| cURL (Bash) | listing |
search |
| PHP | listing |
search |
| C# | listing |
search |
| Go | listing |
search |
| Java | listing |
search |
| Ruby | listing |
search |
| Node.js | listing |
search |
- Listing monitoring — Get alerted when new ads matching your criteria are published.
- Price benchmarks — Compute market prices per model, category or location.
- Sourcing — Find stock, vehicles, parts or equipment faster than manual browsing.
- Market analytics — Measure supply, turnover and pricing trends over time.
- Data products — Feed valuation models and dashboards with structured listings.
- No infrastructure — no proxies, headless browsers or CAPTCHA solving to run yourself.
- Structured JSON — stable, documented fields instead of brittle HTML selectors.
- Pay per request — transparent credit cost per endpoint, failed requests are retried for you.
- One API key, hundreds of sources — Trade-A-Plane plus many other e-commerce, search and company data endpoints in the Piloterr library.
- Any language — plain HTTPS + JSON, with examples for Python, TypeScript, cURL, PHP, C#, Go, Java, Ruby and Node.js.
Collecting publicly available data is generally allowed in many jurisdictions, but rules depend on your country, the data you collect and how you use it. Avoid personal data unless you have a lawful basis, respect the website's terms where they apply, and get legal advice for your specific use case. This is not legal advice.
No. Piloterr handles rendering, proxy rotation and retries on its side. You only send an HTTPS request with your x-api-key header and receive JSON.
Credits per call: /v2/tradeaplane/listing 2, /v2/tradeaplane/search 2. See the Piloterr website for plans.
Each endpoint returns structured JSON: Trade-A-Plane Listing — url, city, make, year, model, phone; Trade-A-Plane Search — results[], results[].url, results[].city, results[].make, results[].year, results[].image.
Use the page parameter and keep requesting while the response indicates more results.
Any language that can make an HTTP request. This README shows Python and TypeScript; the examples/ folder contains cURL, PHP, C#, Go, Java, Ruby and Node.js.
Use Piloterr from your own language with a typed client:
| SDK | Package | Install |
|---|---|---|
| Node.js | @piloterr/sdk |
npm install @piloterr/sdk |
| Python | piloterr |
pip install piloterr |
| Go | piloterr-go |
go get github.com/piloterr/piloterr-go |
| .NET | Piloterr |
dotnet add package Piloterr |
| Ruby | piloterr |
gem install piloterr |
| PHP | piloterr/sdk |
composer require piloterr/sdk |
| Java | piloterr-java |
build from source, see its README |
| CLI | @piloterr/cli |
npm install -g @piloterr/cli |
| MCP server | @piloterr/mcp |
npx -y @piloterr/mcp |
- AutoScout24 Scraper API
- Autotrader Scraper API
- Copart Scraper API
- Kijiji Scraper API
- Leboncoin Scraper API
- Mascus Scraper API
- All Piloterr scrapers on GitHub
- 💬 Join the Piloterr Discord to ask questions and share what you build.
- 📚 Browse the API reference (OpenAPI) and the Piloterr library.
- 🔑 Get your API key.
Built by Piloterr — web scraping APIs for e-commerce, search, real estate and more, one API key.
Trade-A-Plane is a trademark of its respective owner. This repository is not affiliated with or endorsed by Trade-A-Plane. Examples are released under the MIT license.
