# Trade-A-Plane Listing ## Overview | Property | Value | |----------|-------| | **Status** | active | | **Method** | `GET` | | **Endpoint** | `/v2/tradeaplane/listing` | | **Base URL** | `https://api.piloterr.com` | | **Credit Cost** | 2 credits per call | | **Documentation** | https://www.piloterr.com/library/tradeaplane-listing | ## Description Read one Trade-A-Plane aircraft listing from its URL. You get the asking price, the airframe details, and the seller. ## 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/listing' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' ``` ## Example Response ### Rolls Royce Packard V-1650 ```json { "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": "(281) 467-4348", "price": 61750, "title": "ROLLS ROYCE PACKARD V-1650", "images": [ "https://dsgiipnwy1jd8.cloudfront.net/eyJrZXkiOiIxMTAyNjQ4LmpwZyIsImVkaXRzIjp7InJlc2l6ZSI6eyJmaXQiOiJjb250YWluIiwiYmFja2dyb3VuZCI6eyJyIjoyNTUsImIiOjI1NSwiYWxwaGEiOjEsImciOjI1NX19LCJzbWFydE92ZXJsYXkiOnsia2V5Ijoid2F0ZXJtYXJrLnBuZyIsImJ1Y2tldCI6InRhcC1hc3NldHMxIn19LCJidWNrZXQiOiJ0YXAtYXNzZXRzMSJ9", "https://dsgiipnwy1jd8.cloudfront.net/eyJlZGl0cyI6eyJzbWFydE92ZXJsYXkiOnsia2V5Ijoid2F0ZXJtYXJrLnBuZyIsImJ1Y2tldCI6InRhcC1hc3NldHMxIn0sInJlc2l6ZSI6eyJiYWNrZ3JvdW5kIjp7ImFscGhhIjoxLCJnIjoyNTUsInIiOjI1NSwiYiI6MjU1fSwiZml0IjoiY29udGFpbiJ9fSwiYnVja2V0IjoidGFwLWFzc2V0czEiLCJrZXkiOiIxMTAyNjQ5LmpwZyJ9", "https://dsgiipnwy1jd8.cloudfront.net/eyJidWNrZXQiOiJ0YXAtYXNzZXRzMSIsImVkaXRzIjp7InJlc2l6ZSI6eyJmaXQiOiJjb250YWluIiwiYmFja2dyb3VuZCI6eyJiIjoyNTUsInIiOjI1NSwiZyI6MjU1LCJhbHBoYSI6MX19LCJzbWFydE92ZXJsYXkiOnsiYnVja2V0IjoidGFwLWFzc2V0czEiLCJrZXkiOiJ3YXRlcm1hcmsucG5nIn19LCJrZXkiOiIxMTAyNjUxLmpwZyJ9", "https://dsgiipnwy1jd8.cloudfront.net/eyJidWNrZXQiOiJ0YXAtYXNzZXRzMSIsImVkaXRzIjp7InNtYXJ0T3ZlcmxheSI6eyJidWNrZXQiOiJ0YXAtYXNzZXRzMSIsImtleSI6IndhdGVybWFyay5wbmcifSwicmVzaXplIjp7ImZpdCI6ImNvbnRhaW4iLCJiYWNrZ3JvdW5kIjp7ImciOjI1NSwiYWxwaGEiOjEsInIiOjI1NSwiYiI6MjU1fX19LCJrZXkiOiIxMTAyNjYzLmpwZyJ9" ], "region": "TX", "seller": "Terry Sonday", "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 also come with an extra set of -7 heads and banks with valves and springs but NO liners. I sold my Mustang and I have a lot of parts left over P-63 wheels and brakes, 1 overhauled oil cooler. Drop tank hard wear, automotive ignition, canopy frame, overhauled starter motor, like new tail wheel, several brand new canopy covers, Oil Temperature control valve, and lots more parts. Located in Houston, Texas. Call Terry with any question 281-467-4348.", "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" }, { "name": "Make/Model", "value": "ROLLS ROYCE PACKARD V-1650" }, { "name": "Condition", "value": "Overhauled" }, { "name": "Warranty", "value": "Not Listed" }, { "name": "Location", "value": "Spring , TX USA 77379" } ] } ``` ## Documentation ## Overview **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`. ## Quickstart ``` 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 ``` ## `query` **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`. ## Parameters | Parameter | Type | Required | Description | |---|---|---|---| | `query` | string | yes | Listing URL that includes `listing_id` | ## Response fields | 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 }` | ## Notes `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`. ## Main use cases - Open the aircraft a search card pointed to - Store total time, year, and price - Keep the seller contact fields that the page shows ## Error codes | Code | Meaning | |---|---| | `400` | Empty query, unknown host, or a search URL without listing_id | | `403` | Blocked | | `404` | Listing not found | | `500` | Fetch failed | ## Related endpoints [Trade-A-Plane Search](https://www.piloterr.com/library/tradeaplane-search)