Search API for tags, serials or competitor ids
Access & limitsPublic, no key needed · Light▾
Open to everyone. A free API key from your profile raises the limits: send it in an X-API-Key header, or as api_key= in the address.
| 5 minutes | Hour | Day | |
|---|---|---|---|
| Without a key | 30 | 300 | 2,000 |
| With a key | 150 | 1,500 | 10,000 |
Log in to create a free key on your profile page.
Every answer carries X-RateLimit-Remaining and X-RateLimit-Reset. Over a limit, the answer is error 429 with retry_after in seconds. Refused requests do not count.
Présentation
Recherchez les vols publics par numéro de série/MAC, étiquette d’appareil ou étiquette de concurrent, et obtenez une liste paginée. Le terme est recherché n’importe où dans ces champs (sous-chaîne, insensible à la casse). Chaque résultat porte les valeurs clés utiles à une liste : l’identifiant du vol, le numéro de série, l’étiquette, l’apogée, la vignette principale, le lien de la page du vol et le lien de téléchargement du CSV.
Seuls les vols visibles publiquement sont renvoyés, le même ensemble que celui affiché sur les pages de vol publiques.
Point de terminaison
q, limit, page
Paramètres
| Paramètre | Type | Description |
|---|---|---|
q | string | Terme de recherche, au moins 2 caractères. Comparé au numéro de série/MAC, à l’étiquette d’appareil et à l’étiquette de concurrent |
limit | integer | Résultats par page. Par défaut 100, maximum 200 |
page | integer | Numéro de page, à partir de 1. Par défaut 1 |
Requête
curl "https://www.altimetercloud.com/fr/api/flight_search/?q=MY-NANO&limit=50&page=1"
curl "https://www.altimetercloud.com/fr/api/flight_search/?q=1051-dbec"
Réponse
{
"success": true,
"query": "MY-NANO",
"competitor_search": true,
"page": 1,
"limit": 100,
"total": 2,
"count": 2,
"flights": [
{
"id": 1234,
"url": "https://www.altimetercloud.com/fr/flights/1234/",
"csv_url": "https://www.altimetercloud.com/fr/flightdata/4/1234.csv",
"mac": "1051-dbec-747c",
"tag": "MY-NANO",
"competitor_tag": "C-07",
"device": "nanov1",
"firmware": "1.52",
"revision": "4",
"apogee": 246.4,
"apogee_time": 5210,
"uploaddate": "10/06/26-14:22:01",
"uploadstamp": 1781453721,
"thumbnail": "https://www.altimetercloud.com/fr/flightdata/4/1234.webp",
"thumbnail_large": "https://www.altimetercloud.com/fr/flightdata/4/1234_l.webp"
}
]
}
Champs de premier niveau
| Champ | Type | Description |
|---|---|---|
query | string | Le terme de recherche exécuté |
competitor_search | boolean | Si l’étiquette de concurrent a été incluse dans la recherche (voir la note ci-dessous) |
page / limit | integer | La page renvoyée et la taille de page |
total | integer | Nombre total de vols correspondants sur toutes les pages. Divisez par limit pour obtenir le nombre de pages |
count | integer | Nombre de vols sur cette page |
flights | array | La page de résultats |
Champs de résultat
| Champ | Type | Description |
|---|---|---|
id / url | integer / string | Identifiant du vol dans le cloud et sa page de vol publique |
csv_url | string | Lien de téléchargement direct du journal CSV brut |
mac | string | Numéro de série / MAC de l’appareil |
tag / competitor_tag | string | Étiquette d’appareil et étiquette de concurrent |
device / firmware / revision | string | Modèle, version du micrologiciel et révision matérielle |
apogee | float | Altitude maximale en mètres |
apogee_time | integer | Instant de l’apogée en millisecondes |
uploaddate / uploadstamp | string / integer | Texte de date de téléversement et horodatage Unix |
thumbnail / thumbnail_large | string | Image principale du graphique (mètres), petite et grande |
Recherche par étiquette de concurrent
L’indicateur competitor_search signale si l’étiquette de concurrent faisait partie de la recherche. L’étiquette de concurrent est lue dans le journal de vol au moment du téléversement ; si votre installation la stocke comme colonne de vol, ce point de terminaison la recherche et la renvoie automatiquement. Sinon, la recherche ne couvre que le numéro de série/MAC et l’étiquette d’appareil, et competitor_search vaut false. Pour obtenir malgré tout l’étiquette de concurrent d’un seul vol, utilisez le point de terminaison Infos de vol, qui la lit directement dans le journal.
Bac à sable de l’API
Saisissez un terme (numéro de série, étiquette ou concurrent) et cliquez sur Exécuter pour rechercher.
Crediting AltimeterCloud
Free to use. If you use this API, or anything made from the answers, in a commercial product or service, credit AltimeterCloud with a link to www.altimetercloud.com at the point of use: on the screen, page or printout where the data appears, for example “Data from AltimeterCloud.com”. Any credits the data's own sources ask for, listed on this page, apply as well.



















