Free satellite position API

Where any satellite is right now, as JSON. Free, no sign-up and no key: use it in a club page, a classroom project, a Raspberry Pi display or your own tracker.

Step by step: how to use it

No programming needed for steps 1–3 and 5. Each step builds on the one before.

  1. 1. See it in your browser

    Copy the address below into your browser's address bar and press Enter. You will see a short block of text (JSON) with where the ISS is right now. Press refresh and the numbers change: it is live.

    https://orbitnight.com/api/v1/satellites/25544/position
  2. 2. Pick your satellite (NORAD number)

    Every satellite has a catalogue number. Search for it in the search box at the top of this site: the number is at the end of the satellite page's address (orbitnight.com/satellite/25544). A few to try: ISS 25544, Tiangong 48274, Hubble 20580, AO-91 43017, NOAA 19 33591. Put that number in place of 25544 in the address.

    https://orbitnight.com/api/v1/satellites/48274/position
  3. 3. Add your location

    On Google Maps, right-click your town and click the two numbers at the top of the menu to copy them (latitude, longitude). Add them to the address as ?lat=…&lon=… (south and west are negative). The answer then says where the satellite is in your sky: elevationDeg above 0 means it is above your horizon right now.

    https://orbitnight.com/api/v1/satellites/25544/position?lat=37.57&lon=126.98
  4. 4. Put it on a web page (copy and paste)

    Paste this into any HTML page (a blog in HTML mode works). It shows the satellite's position and updates every 5 seconds. Change 25544 to your satellite.

    <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. 5. Use it in a spreadsheet

    Add &format=csv (or ?format=csv if the address has no ?) and you get a spreadsheet row instead. Google Sheets: type the formula below into a cell. Excel: Data → From Web → paste the address.

    =IMPORTDATA("https://orbitnight.com/api/v1/satellites/25544/position?format=csv")
  6. 6. Use it in Python

    For a Raspberry Pi display, a bot or a school project:

    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. 7. Credit us

    On a public page, please add a visible link like the one below. It keeps the API free for everyone.

    <a href="https://orbitnight.com">Satellite data: OrbitNight</a>

What each value means

latitude, longitude
The point on Earth directly below the satellite, in degrees (south and west are negative).
altitudeKm
Height above sea level in kilometres.
velocityKmS
Speed in kilometres per second (the ISS: about 7.7).
sunlit
true when sunlight reaches the satellite. You can only see it with your eyes when it is sunlit and your sky is dark.
observer.azimuthDeg
Compass direction from you: 0 north, 90 east, 180 south, 270 west.
observer.elevationDeg
Height above your horizon: 0 on the horizon, 90 straight overhead, below 0 not visible.
observer.rangeKm
Straight-line distance from you.
timestamp
The moment of the position (UTC).

If something goes wrong

invalid_id (400)
The number is not a NORAD number. Use digits only, e.g. 25544.
invalid_observer (400)
Give both lat and lon, or neither; lat −90…90, lon −180…180.
not_found (404)
No satellite has that number.
not_in_orbit (410)
It has re-entered or is not in orbit.
rate_limited (429)
More than 60 calls in a minute. Wait a minute; poll every few seconds, not faster.
unavailable (503)
The server is restarting. Try again in 30 seconds.

Endpoint

GET https://orbitnight.com/api/v1/satellites/{id}/position

Parameters

Example answer

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"
}

Limits

Please credit us

If you use it on a public page, please add a visible link to https://orbitnight.com. It keeps the API free.

Rather paste a widget?

Every satellite page has a live globe widget you can copy into any site, with the next pass over your town. Example: ISS (ZARYA) →