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.
Resumen
Busque vuelos públicos por número de serie/MAC, etiqueta de dispositivo o etiqueta de competidor, y obtenga una lista paginada. El término se busca en cualquier parte de esos campos (subcadena, sin distinguir mayúsculas). Cada resultado lleva los valores clave que necesita una vista de lista: el id del vuelo, el número de serie, la etiqueta, el apogeo, la miniatura principal, el enlace a la página del vuelo y el enlace de descarga del CSV.
Solo se devuelven los vuelos visibles públicamente, el mismo conjunto que se muestra en las páginas de vuelo públicas.
Punto final
q, limit, page
Parámetros
| Parámetro | Tipo | Descripción |
|---|---|---|
q | string | Término de búsqueda, al menos 2 caracteres. Comparado con número de serie/MAC, etiqueta de dispositivo y etiqueta de competidor |
limit | integer | Resultados por página. Predeterminado 100, máximo 200 |
page | integer | Número de página, empezando en 1. Predeterminado 1 |
Solicitud
curl "https://www.altimetercloud.com/es/api/flight_search/?q=MY-NANO&limit=50&page=1"
curl "https://www.altimetercloud.com/es/api/flight_search/?q=1051-dbec"
Respuesta
{
"success": true,
"query": "MY-NANO",
"competitor_search": true,
"page": 1,
"limit": 100,
"total": 2,
"count": 2,
"flights": [
{
"id": 1234,
"url": "https://www.altimetercloud.com/es/flights/1234/",
"csv_url": "https://www.altimetercloud.com/es/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/es/flightdata/4/1234.webp",
"thumbnail_large": "https://www.altimetercloud.com/es/flightdata/4/1234_l.webp"
}
]
}
Campos de nivel superior
| Campo | Tipo | Descripción |
|---|---|---|
query | string | El término de búsqueda ejecutado |
competitor_search | boolean | Si la etiqueta de competidor se incluyó en la búsqueda (vea la nota más abajo) |
page / limit | integer | La página devuelta y el tamaño de página |
total | integer | Total de vuelos coincidentes en todas las páginas. Divida entre limit para obtener el número de páginas |
count | integer | Número de vuelos en esta página |
flights | array | La página de resultados |
Campos de resultado
| Campo | Tipo | Descripción |
|---|---|---|
id / url | integer / string | Id del vuelo en la nube y su página de vuelo pública |
csv_url | string | Enlace de descarga directa del registro CSV sin procesar |
mac | string | Número de serie / MAC del dispositivo |
tag / competitor_tag | string | Etiqueta de dispositivo y etiqueta de competidor |
device / firmware / revision | string | Modelo, versión de firmware y revisión de hardware |
apogee | float | Altitud máxima en metros |
apogee_time | integer | Momento del apogeo en milisegundos |
uploaddate / uploadstamp | string / integer | Texto de fecha de carga y marca de tiempo Unix |
thumbnail / thumbnail_large | string | Imagen principal del gráfico (metros), pequeña y grande |
Búsqueda por etiqueta de competidor
El indicador competitor_search informa de si la etiqueta de competidor formó parte de la búsqueda. La etiqueta de competidor se lee del registro de vuelo al cargarlo; si su instalación la almacena como columna de vuelo, este punto final la busca y la devuelve automáticamente. Si no, la búsqueda solo cubre número de serie/MAC y etiqueta de dispositivo, y competitor_search es false. Para obtener de todos modos la etiqueta de competidor de un solo vuelo, use el punto final Información de vuelo, que la lee directamente del registro.
Zona de pruebas de la API
Introduzca un término (número de serie, etiqueta o competidor) y haga clic en Ejecutar para buscar.
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.



















