API gratuita de posición de satélites
Dónde está cualquier satélite ahora mismo, en JSON. Gratis, sin registro y sin clave: úsala en la página de tu club, un proyecto escolar, una pantalla con Raspberry Pi o tu propio rastreador.
Paso a paso: cómo usarla
Los pasos 1–3 y 5 no requieren programar. Cada paso añade algo al anterior.
1. Mírala en tu navegador
Copia la dirección de abajo en la barra del navegador y pulsa Enter. Verás un bloque corto de texto (JSON) con dónde está la ISS ahora mismo. Recarga y los números cambian: es en vivo.
https://orbitnight.com/api/v1/satellites/25544/position
2. Elige tu satélite (número NORAD)
Cada satélite tiene un número de catálogo. Búscalo en el buscador de arriba de este sitio: el número está al final de la dirección de su página (orbitnight.com/satellite/25544). Algunos para probar: ISS 25544, Tiangong 48274, Hubble 20580, AO-91 43017, NOAA 19 33591. Pon ese número en lugar de 25544.
https://orbitnight.com/api/v1/satellites/48274/position
3. Añade tu ubicación
En Google Maps, haz clic derecho en tu ciudad y pulsa los dos números del menú para copiarlos (latitud, longitud). Añádelos a la dirección como ?lat=…&lon=… (sur y oeste en negativo). La respuesta dirá dónde está el satélite en tu cielo: elevationDeg mayor que 0 significa que está sobre tu horizonte.
https://orbitnight.com/api/v1/satellites/25544/position?lat=37.57&lon=126.98
4. Ponla en una página web (copiar y pegar)
Pega esto en cualquier página HTML (un blog en modo HTML sirve). Muestra la posición del satélite y se actualiza cada 5 segundos. Cambia 25544 por tu satélite.
<div id="sat">…</div> <script> // Change 25544 to any NORAD number. Updates every 5 seconds. async function show() { const r = await fetch("https://orbitnight.com/api/v1/satellites/25544/position"); const s = await r.json(); document.getElementById("sat").textContent = s.name + ": " + s.latitude + "°, " + s.longitude + "° · " + Math.round(s.altitudeKm) + " km up · " + s.velocityKmS + " km/s"; } show(); setInterval(show, 5000); </script> <a href="https://orbitnight.com">Satellite data: OrbitNight</a>5. Úsala en una hoja de cálculo
Añade &format=csv (o ?format=csv si la dirección no tiene ?) y recibirás una fila de hoja de cálculo. Google Sheets: escribe la fórmula de abajo en una celda. Excel: Datos → Desde la web → pega la dirección.
=IMPORTDATA("https://orbitnight.com/api/v1/satellites/25544/position?format=csv")6. Úsala en Python
Para una pantalla con Raspberry Pi, un bot o un proyecto escolar:
import requests r = requests.get("https://orbitnight.com/api/v1/satellites/25544/position", params={"lat": 37.57, "lon": 126.98}) s = r.json() print(s["name"], s["latitude"], s["longitude"], round(s["altitudeKm"]), "km") if s["observer"]["elevationDeg"] > 0: print("It is above your horizon right now!")7. Cítanos
En una página pública, añade un enlace visible como el de abajo. Así la API sigue siendo gratis para todos.
<a href="https://orbitnight.com">Satellite data: OrbitNight</a>
Qué significa cada valor
- latitude, longitude
- El punto de la Tierra justo debajo del satélite, en grados (sur y oeste en negativo).
- altitudeKm
- Altura sobre el nivel del mar en kilómetros.
- velocityKmS
- Velocidad en kilómetros por segundo (la ISS: unos 7,7).
- sunlit
- true cuando la luz del sol llega al satélite. Solo se ve a simple vista si está al sol y tu cielo está oscuro.
- observer.azimuthDeg
- Dirección desde ti: 0 norte, 90 este, 180 sur, 270 oeste.
- observer.elevationDeg
- Altura sobre tu horizonte: 0 en el horizonte, 90 justo encima, menos de 0 no visible.
- observer.rangeKm
- Distancia en línea recta desde ti.
- timestamp
- El momento de la posición (UTC).
Si algo falla
- invalid_id (400)
- No es un número NORAD. Usa solo cifras, p. ej. 25544.
- invalid_observer (400)
- Da lat y lon juntos, o ninguno; lat −90…90, lon −180…180.
- not_found (404)
- Ningún satélite tiene ese número.
- not_in_orbit (410)
- Ya reentró o no está en órbita.
- rate_limited (429)
- Más de 60 llamadas en un minuto. Espera un minuto; consulta cada pocos segundos.
- unavailable (503)
- El servidor se está reiniciando. Inténtalo en 30 segundos.
Dirección
GET https://orbitnight.com/api/v1/satellites/{id}/positionParámetros
- id: el número de catálogo NORAD (25544 es la ISS).
- lat, lon (opcional): tu ubicación en grados. La respuesta añade dónde está el satélite en tu cielo: acimut, elevación y distancia.
Respuesta de ejemplo
https://orbitnight.com/api/v1/satellites/25544/position?lat=37.57&lon=126.98
{
"noradId": "25544",
"name": "ISS (ZARYA)",
"timestamp": "2026-11-20T14:00:00.000Z",
"latitude": 21.4127,
"longitude": 143.0981,
"altitudeKm": 418.62,
"velocityKmS": 7.664,
"sunlit": true,
"observer": {
"latitude": 37.57,
"longitude": 126.98,
"azimuthDeg": 141.35,
"elevationDeg": 3.18,
"rangeKm": 2091.4
},
"page": "https://orbitnight.com/satellite/25544",
"attribution": "OrbitNight (https://orbitnight.com). Orbital data: US Space Force via Space-Track.org"
}Límites
- Hasta 60 peticiones por minuto por red. Consultar cada pocos segundos está bien.
- Las posiciones se calculan con SGP4 a partir de los elementos orbitales de la Fuerza Espacial de EE. UU., actualizados cada hora.
- Los errores llegan en JSON con un código: invalid_id, not_found, not_in_orbit, rate_limited, unavailable.
Cita la fuente, por favor
Si la usas en una página pública, añade un enlace visible a https://orbitnight.com. Así la API puede seguir siendo gratis.
¿Prefieres pegar un widget?
Cada página de satélite tiene un widget con un globo en vivo que puedes copiar en cualquier sitio, con el próximo paso sobre tu ciudad. Ejemplo: ISS (ZARYA) →