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.
Overzicht
Doorzoek openbare vluchten op serienummer/MAC, apparaatlabel of deelnemerslabel en krijg een gepagineerde lijst terug. De term wordt overal in die velden gezocht (deeltekst, hoofdletterongevoelig). Elk resultaat bevat de kerngegevens die een lijstweergave nodig heeft: het vlucht-id, serienummer, label, apogee, de hoofdminiatuur, de link naar de vluchtpagina en de CSV-downloadlink.
Alleen openbaar zichtbare vluchten worden teruggegeven, dezelfde set die op de openbare vluchtpagina's wordt getoond.
Eindpunt
q, limit, page
Parameters
| Parameter | Type | Beschrijving |
|---|---|---|
q | string | Zoekterm, minstens 2 tekens. Vergeleken met serienummer/MAC, apparaatlabel en deelnemerslabel |
limit | integer | Resultaten per pagina. Standaard 100, maximum 200 |
page | integer | Paginanummer, beginnend bij 1. Standaard 1 |
Verzoek
curl "https://www.altimetercloud.com/nl/api/flight_search/?q=MY-NANO&limit=50&page=1"
curl "https://www.altimetercloud.com/nl/api/flight_search/?q=1051-dbec"
Antwoord
{
"success": true,
"query": "MY-NANO",
"competitor_search": true,
"page": 1,
"limit": 100,
"total": 2,
"count": 2,
"flights": [
{
"id": 1234,
"url": "https://www.altimetercloud.com/nl/flights/1234/",
"csv_url": "https://www.altimetercloud.com/nl/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/nl/flightdata/4/1234.webp",
"thumbnail_large": "https://www.altimetercloud.com/nl/flightdata/4/1234_l.webp"
}
]
}
Velden op hoofdniveau
| Veld | Type | Beschrijving |
|---|---|---|
query | string | De uitgevoerde zoekterm |
competitor_search | boolean | Of het deelnemerslabel deel uitmaakte van het zoeken (zie opmerking hieronder) |
page / limit | integer | De teruggegeven pagina en de paginagrootte |
total | integer | Totaal aantal overeenkomende vluchten over alle pagina's. Deel door limit voor het aantal pagina's |
count | integer | Aantal vluchten op deze pagina |
flights | array | De resultatenpagina |
Resultaatvelden
| Veld | Type | Beschrijving |
|---|---|---|
id / url | integer / string | Cloud-vlucht-id en de openbare vluchtpagina |
csv_url | string | Directe downloadlink voor het ruwe CSV-log |
mac | string | Serienummer / MAC van het apparaat |
tag / competitor_tag | string | Apparaatlabel en deelnemerslabel |
device / firmware / revision | string | Model, firmwareversie en hardwarerevisie |
apogee | float | Maximale hoogte in meters |
apogee_time | integer | Tijdstip van apogeum in milliseconden |
uploaddate / uploadstamp | string / integer | Uploaddatumtekst en Unix-tijdstempel |
thumbnail / thumbnail_large | string | Hoofdgrafiekafbeelding (meters), klein en groot |
Zoeken op deelnemerslabel
De vlag competitor_search geeft aan of het deelnemerslabel deel uitmaakte van het zoeken. Het deelnemerslabel wordt bij het uploaden uit het vluchtlog gelezen; als uw installatie het als vluchtkolom opslaat, doorzoekt en retourneert dit eindpunt het automatisch. Zo niet, dan dekt het zoeken alleen serienummer/MAC en apparaatlabel, en is competitor_search gelijk aan false. Om toch het deelnemerslabel van een enkele vlucht op te halen, gebruikt u het eindpunt Vluchtinformatie, dat het rechtstreeks uit het log leest.
API-speeltuin
Voer een term in (serienummer, label of deelnemer) en klik op Uitvoeren om te zoeken.
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.



















