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.
Überblick
Durchsuchen Sie öffentliche Flüge nach Seriennummer/MAC, Geräte-Tag oder Teilnehmer-Tag und erhalten Sie eine paginierte Liste. Der Begriff wird an beliebiger Stelle in diesen Feldern abgeglichen (Teilstring, Groß-/Kleinschreibung egal). Jedes Ergebnis enthält die wichtigsten Werte für eine Listenansicht: Flug-ID, Seriennummer, Tag, Gipfelhöhe, das Haupt-Diagrammbild, den Link zur Flugseite und den Link zum CSV-Download.
Es werden nur öffentlich sichtbare Flüge zurückgegeben, dieselbe Menge wie auf den öffentlichen Flugseiten.
Endpunkt
q, limit, page
Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
q | string | Suchbegriff, mindestens 2 Zeichen. Abgeglichen mit Seriennummer/MAC, Geräte-Tag und Teilnehmer-Tag |
limit | integer | Ergebnisse pro Seite. Standard 100, Maximum 200 |
page | integer | Seitennummer, beginnend bei 1. Standard 1 |
Anfrage
curl "https://www.altimetercloud.com/de/api/flight_search/?q=MY-NANO&limit=50&page=1"
curl "https://www.altimetercloud.com/de/api/flight_search/?q=1051-dbec"
Antwort
{
"success": true,
"query": "MY-NANO",
"competitor_search": true,
"page": 1,
"limit": 100,
"total": 2,
"count": 2,
"flights": [
{
"id": 1234,
"url": "https://www.altimetercloud.com/de/flights/1234/",
"csv_url": "https://www.altimetercloud.com/de/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/de/flightdata/4/1234.webp",
"thumbnail_large": "https://www.altimetercloud.com/de/flightdata/4/1234_l.webp"
}
]
}
Felder der obersten Ebene
| Feld | Typ | Beschreibung |
|---|---|---|
query | string | Der ausgeführte Suchbegriff |
competitor_search | boolean | Ob das Teilnehmer-Tag in die Suche einbezogen wurde (siehe Hinweis unten) |
page / limit | integer | Die zurückgegebene Seite und die Seitengröße |
total | integer | Gesamtzahl passender Flüge über alle Seiten. Durch limit teilen, um die Seitenzahl zu erhalten |
count | integer | Anzahl der Flüge auf dieser Seite |
flights | array | Die Ergebnisseite |
Ergebnisfelder
| Feld | Typ | Beschreibung |
|---|---|---|
id / url | integer / string | Cloud-Flug-ID und ihre öffentliche Flugseite |
csv_url | string | Direkter Download-Link für das CSV-Rohprotokoll |
mac | string | Geräte-Seriennummer / MAC |
tag / competitor_tag | string | Geräte-Tag und Teilnehmer-Tag |
device / firmware / revision | string | Modell, Firmware-Version und Hardware-Revision |
apogee | float | Maximalhöhe in Metern |
apogee_time | integer | Zeitpunkt des Gipfelpunkts in Millisekunden |
uploaddate / uploadstamp | string / integer | Upload-Datumstext und Unix-Zeitstempel |
thumbnail / thumbnail_large | string | Haupt-Diagrammbild (Meter), klein und groß |
Suche nach Teilnehmer-Tag
Das Kennzeichen competitor_search gibt an, ob das Teilnehmer-Tag Teil der Suche war. Das Teilnehmer-Tag wird beim Hochladen aus dem Flugprotokoll gelesen; wenn Ihre Installation es als Flugspalte speichert, durchsucht und liefert dieser Endpunkt es automatisch. Andernfalls deckt die Suche nur Seriennummer/MAC und Geräte-Tag ab, und competitor_search ist false. Um das Teilnehmer-Tag eines einzelnen Flugs dennoch abzurufen, verwenden Sie den Endpunkt Flugdaten, der es direkt aus dem Protokoll liest.
API-Playground
Geben Sie einen Begriff ein (Seriennummer, Tag oder Teilnehmer) und klicken Sie auf Ausführen, um zu suchen.
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.



















