Aller au contenu principal
Piloterr
Retour à la bibliothèque

API Trade-A-Plane Search

Recherchez des annonces Trade-A-Plane par mot-clé et parcourez les pages. Les cartes ont le titre, le prix et le lien.

Actif2 crédits = 1 requêteGET/v2/tradeaplane/search

Vue d'ensemble de l'endpoint

Documentation détaillée, tarifs et exemples d'utilisation.

Vue d'ensembleLink to Vue d'ensemble

Recherche Trade-A-Plane d'avions et de moteurs.

query est un mot-clé ou une URL /filtered/search ou /search. Avec un mot-clé, listing_type vaut aircraft ou engine. La réponse est { results, pagination }.

Une URL qui contient déjà listing_id renvoie 400.

Démarrage rapideLink to Démarrage rapide

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

Exemple (mot-clé moteur):

rol

Exemple (mot-clé avion):

spirit

Exemple (URL de recherche):

https://www.trade-a-plane.com/filtered/search?s-type=aircraft&s-keyword-search=spirit&s-original-search=spirit

query est obligatoire. Seul www.trade-a-plane.com est accepté.

Forme Exemple Effet
Mot-clé, moteurs rol + listing_type=engine Construit /filtered/search?s-type=engine&s-keyword-search=rol.
Mot-clé, avions spirit + listing_type=aircraft Construit /filtered/search?s-type=aircraft&s-keyword-search=spirit.
URL de recherche https://www.trade-a-plane.com/filtered/search?s-type=engine&s-keyword-search=rol&s-original-search=rol Utilise cette recherche. page est envoyé comme s-page.

Une URL d'annonce renvoie 400. Un mot-clé sans listing_type renvoie 400. Un autre hôte renvoie 400. page inférieur à 1 renvoie 400.

page commence à 1. La page 2 est s-page=2 sur la même recherche.

ParamètresLink to Paramètres

Paramètre Type Obligatoire Description
query string oui Mot-clé, ou URL /filtered/search ou /search sans listing_id
listing_type string non aircraft ou engine quand query est un mot-clé. Ignoré si query est une URL.
page integer non Page à partir de 1. Envoyée comme s-page.

Champs de la réponseLink to Champs de la réponse

Champ 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 est un nombre en USD. price_display reprend le texte de la carte, y compris Call for Price quand il n'y a pas de montant. condition concerne les moteurs. registration concerne les avions (Reg#). total_time vaut null quand la carte dit Not Listed. phone est le numéro du vendeur. total_results vient de Showing 1 - N of M results.

Cas d'utilisationLink to Cas d'utilisation

  • Balayer pistons, turbines ou un modèle
  • Parcourir une marque comme Cessna ou Piper
  • Reprendre une URL dans l'appel annonce

Codes d'erreurLink to Codes d'erreur

Code Signification
400 Requête vide, listing_type manquant, hôte inconnu, ou URL d'annonce
403 Bloqué
404 Aucune annonce sur la page
500 Échec de la récupération

Endpoints liésLink to Endpoints liés

Trade-A-Plane Annonce

API associées

Étendez vos capacités data avec ces outils complémentaires.

Prêt à commencer ?

Votre API de scraping web est à un clic. Commencez avec +500 crédits, sans infrastructure à gérer, sans proxies à configurer, et sans carte bancaire.

  • +500 crédits
  • Aucune carte bancaire requise
  • Tous les endpoints inclus