find_satellites_above

List satellites above an observer within an angular search radius.

Signature: find_satellites_above(observer_lat: decimal number, decimal degrees (WGS84), required; observer_lon: decimal number, decimal degrees (WGS84), required; observer_alt_m: decimal number, metres, optional, default 0; radius_deg: integer, degrees, optional, default 30; category_id: integer, optional, default 0; limit: integer, items, optional, default 25; offset: integer, items, optional, default 0)

Direct GET

For navigating agents: open the HTML page with parameters in the URL. The result is fetched and displayed without screenshots or form filling.

Open this validated HTML GET URL

https://allemannsdata.com/wiki/kilder/n2yo/find_satellites_above/?observer_lat={observer_lat}&observer_lon={observer_lon}&observer_alt_m=0&radius_deg=30&category_id=0&limit=25&offset=0

Replace {observer_lat}, {observer_lon}, {observer_alt_m}, {radius_deg}, {category_id} with values. Remove unused optional parameters from the URL.

For software and dashboards: Read the operation descriptor. The JSON GET template is https://allemannsdata.com/wiki/api/v1/kilder/n2yo/find_satellites_above?observer_lat={observer_lat}&observer_lon={observer_lon}&observer_alt_m=0&radius_deg=30&category_id=0&limit=25&offset=0. Open this exact request as JSON.

ParameterRequirementJSON typeDescription
observer_latrequirednumberObserver latitude in WGS84 decimal degrees. Unit: decimal degrees (WGS84).
observer_lonrequirednumberObserver longitude in WGS84 decimal degrees. Unit: decimal degrees (WGS84).
observer_alt_moptionalnumberObserver altitude above sea level in metres. Unit: metres.
radius_degoptionalintegerSearch radius from 0 to 90 degrees. Unit: degrees.
category_idoptionalintegerN2YO category id; 0 means all categories, 1 brightest.
limitoptionalintegerGateway page size; default 25, maximum 100.
offsetoptionalintegerNumber of list items to skip; default 0.
Generated JavaScript, Python and response structure

Use JSON when the user requests code, machine-readable data, value extraction or further computation. Use the HTML GET page to identify the correct source and verify parameters.

Example for generated JavaScript and Python

https://allemannsdata.com/wiki/api/v1/kilder/n2yo/find_satellites_above?observer_lat={observer_lat}&observer_lon={observer_lon}&observer_alt_m=0&radius_deg=30&category_id=0&limit=25&offset=0

Replace URL placeholders and remove unused optional parameters.

JavaScript in a dashboard

const url = "https://allemannsdata.com/wiki/api/v1/kilder/n2yo/find_satellites_above?observer_lat={observer_lat}&observer_lon={observer_lon}&observer_alt_m=0&radius_deg=30&category_id=0&limit=25&offset=0";
const response = await fetch(url);
if (!response.ok) {
  const failure = await response.json();
  throw new Error(`${failure.error.code}: ${failure.error.message} ${failure.suggestion}`);
}
const result = await response.json();
const data = result.data;

Python without additional packages

import json
from urllib.request import urlopen

url = "https://allemannsdata.com/wiki/api/v1/kilder/n2yo/find_satellites_above?observer_lat={observer_lat}&observer_lon={observer_lon}&observer_alt_m=0&radius_deg=30&category_id=0&limit=25&offset=0"
with urlopen(url) as response:
    result = json.load(response)
data = result["data"]

Response structure

{
  "source": "n2yo",
  "operation": "find_satellites_above",
  "parameters": {},
  "data": {},
  "entities": [],
  "_meta": {"retrieved_at": "...", "sources": [], "cache": {}},
  "_links": {"self": "...", "source": "...", "wiki": "...", "feedback": "..."}
}
Form for manual use

The form is a fallback for people and browser agents that cannot open the GET URL directly.

Type: decimal number. Observer latitude in WGS84 decimal degrees. Unit: decimal degrees (WGS84).
Type: decimal number. Observer longitude in WGS84 decimal degrees. Unit: decimal degrees (WGS84).
Type: decimal number. Observer altitude above sea level in metres. Unit: metres.
Type: integer. Search radius from 0 to 90 degrees. Unit: degrees.
Type: integer. N2YO category id; 0 means all categories, 1 brightest.

Result

Source: N2YO satellite data. Retrieved 2026-10-16T03:00:46Z in 1.069 seconds.

info:
category:
ANY
transactionscount:
100
satcount:
115
above:

25 results

  1. satid:
    545
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1961-015GE
    launchDate:
    1961-06-29
    satlat:
    66.7805
    satlng:
    27.3637
    satalt:
    1097.0908
  2. satid:
    4177
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1969-082AV
    launchDate:
    1969-09-30
    satlat:
    67.2773
    satlng:
    13.5429
    satalt:
    945.4434
  3. satid:
    5054
    satname:
    TITAN 34B AGENA D R/B
    intDesignator:
    1971-021B
    launchDate:
    1971-03-21
    satlat:
    57.2543
    satlng:
    -28.5244
    satalt:
    31979.391
  4. satid:
    9666
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025NK
    launchDate:
    1970-04-08
    satlat:
    68.8416
    satlng:
    23.5268
    satalt:
    1051.661
  5. satid:
    9841
    satname:
    TANSEI 3 (MS-T3)
    intDesignator:
    1977-012A
    launchDate:
    1977-02-19
    satlat:
    63.6508
    satlng:
    17.6188
    satalt:
    3431.1758
  6. satid:
    11690
    satname:
    OPS 5117 (NAVSTAR 5)
    intDesignator:
    1980-011A
    launchDate:
    1980-02-09
    satlat:
    64.7272
    satlng:
    57.5753
    satalt:
    20757.3973
  7. satid:
    11880
    satname:
    COSMOS 1197
    intDesignator:
    1980-058F
    launchDate:
    1980-07-09
    satlat:
    72.8398
    satlng:
    6.2349
    satalt:
    1502.7318
  8. satid:
    11909
    satname:
    SL-6 R/B(2)
    intDesignator:
    1980-063D
    launchDate:
    1980-07-18
    satlat:
    62.2887
    satlng:
    1.6316
    satalt:
    35278.1037
  9. satid:
    12663
    satname:
    COSMOS 1275 DEB
    intDesignator:
    1981-053T
    launchDate:
    1981-06-04
    satlat:
    67.4705
    satlng:
    16.5607
    satalt:
    959.3017
  10. satid:
    13012
    satname:
    MOLNIYA 1-52
    intDesignator:
    1981-123A
    launchDate:
    1981-12-23
    satlat:
    61.7911
    satlng:
    71.4041
    satalt:
    39007.8117
  11. satid:
    13016
    satname:
    SL-6 R/B(2)
    intDesignator:
    1981-123D
    launchDate:
    1981-12-23
    satlat:
    60.1832
    satlng:
    -23.2507
    satalt:
    23875.266
  12. satid:
    13169
    satname:
    SL-6 R/B(2)
    intDesignator:
    1982-029D
    launchDate:
    1982-04-07
    satlat:
    62.8167
    satlng:
    33.1428
    satalt:
    32033.7714
  13. satid:
    14189
    satname:
    OPS 9794 (NAVSTAR 8)
    intDesignator:
    1983-072A
    launchDate:
    1983-07-14
    satlat:
    63.2097
    satlng:
    75.586
    satalt:
    20458.571
  14. satid:
    14259
    satname:
    COSMOS 1491 (GLONASS)
    intDesignator:
    1983-084B
    launchDate:
    1983-08-10
    satlat:
    47.6911
    satlng:
    14.5697
    satalt:
    18970.5799
  15. satid:
    14591
    satname:
    COSMOS 1520 (GLONASS)
    intDesignator:
    1983-127B
    launchDate:
    1983-12-29
    satlat:
    63.2696
    satlng:
    14.9767
    satalt:
    19116.0594
  16. satid:
    14884
    satname:
    COSMOS 1547
    intDesignator:
    1984-033A
    launchDate:
    1984-04-04
    satlat:
    72.0049
    satlng:
    -30.5964
    satalt:
    31763.5099
  17. satid:
    15039
    satname:
    NAVSTAR 9 (USA 1)
    intDesignator:
    1984-059A
    launchDate:
    1984-06-13
    satlat:
    56.8444
    satlng:
    40.0969
    satalt:
    20297.0569
  18. satid:
    15098
    satname:
    SL-6 R/B(2)
    intDesignator:
    1984-071D
    launchDate:
    1984-07-03
    satlat:
    72.158
    satlng:
    35.9766
    satalt:
    34348.7916
  19. satid:
    15261
    satname:
    COSMOS 1595 (GLONASS)
    intDesignator:
    1984-095C
    launchDate:
    1984-09-04
    satlat:
    50.942
    satlng:
    32.4254
    satalt:
    19251.9943
  20. satid:
    15429
    satname:
    MOLNIYA 1-63
    intDesignator:
    1984-124A
    launchDate:
    1984-12-14
    satlat:
    59.6676
    satlng:
    21.2134
    satalt:
    30010.7267
  21. satid:
    15439
    satname:
    SL-6 R/B(2)
    intDesignator:
    1984-124H
    launchDate:
    1984-12-14
    satlat:
    61.8489
    satlng:
    -19.4997
    satalt:
    40405.6468
  22. satid:
    16103
    satname:
    COSMOS 1687
    intDesignator:
    1985-088A
    launchDate:
    1985-09-30
    satlat:
    72.0183
    satlng:
    31.7088
    satalt:
    18729.7416
  23. satid:
    16186
    satname:
    SL-6 R/B(2)
    intDesignator:
    1985-098D
    launchDate:
    1985-10-22
    satlat:
    69.6813
    satlng:
    47.8318
    satalt:
    18838.8395
  24. satid:
    16397
    satname:
    COSMOS 1711 (GLONASS)
    intDesignator:
    1985-118B
    launchDate:
    1985-12-24
    satlat:
    64.0505
    satlng:
    4.5535
    satalt:
    19139.4329
  25. satid:
    16402
    satname:
    SL-6 R/B(2)
    intDesignator:
    1985-117F
    launchDate:
    1985-12-24
    satlat:
    62.5153
    satlng:
    47.1377
    satalt:
    32522.4482
limit:
25
offset:
0
returned:
25
has_more_results:
yes
next_offset:
25
Show all fields in HTML
info:
category:
ANY
transactionscount:
100
satcount:
115
above:

25 results

  1. satid:
    545
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1961-015GE
    launchDate:
    1961-06-29
    satlat:
    66.7805
    satlng:
    27.3637
    satalt:
    1097.0908
  2. satid:
    4177
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1969-082AV
    launchDate:
    1969-09-30
    satlat:
    67.2773
    satlng:
    13.5429
    satalt:
    945.4434
  3. satid:
    5054
    satname:
    TITAN 34B AGENA D R/B
    intDesignator:
    1971-021B
    launchDate:
    1971-03-21
    satlat:
    57.2543
    satlng:
    -28.5244
    satalt:
    31979.391
  4. satid:
    9666
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025NK
    launchDate:
    1970-04-08
    satlat:
    68.8416
    satlng:
    23.5268
    satalt:
    1051.661
  5. satid:
    9841
    satname:
    TANSEI 3 (MS-T3)
    intDesignator:
    1977-012A
    launchDate:
    1977-02-19
    satlat:
    63.6508
    satlng:
    17.6188
    satalt:
    3431.1758
  6. satid:
    11690
    satname:
    OPS 5117 (NAVSTAR 5)
    intDesignator:
    1980-011A
    launchDate:
    1980-02-09
    satlat:
    64.7272
    satlng:
    57.5753
    satalt:
    20757.3973
  7. satid:
    11880
    satname:
    COSMOS 1197
    intDesignator:
    1980-058F
    launchDate:
    1980-07-09
    satlat:
    72.8398
    satlng:
    6.2349
    satalt:
    1502.7318
  8. satid:
    11909
    satname:
    SL-6 R/B(2)
    intDesignator:
    1980-063D
    launchDate:
    1980-07-18
    satlat:
    62.2887
    satlng:
    1.6316
    satalt:
    35278.1037
  9. satid:
    12663
    satname:
    COSMOS 1275 DEB
    intDesignator:
    1981-053T
    launchDate:
    1981-06-04
    satlat:
    67.4705
    satlng:
    16.5607
    satalt:
    959.3017
  10. satid:
    13012
    satname:
    MOLNIYA 1-52
    intDesignator:
    1981-123A
    launchDate:
    1981-12-23
    satlat:
    61.7911
    satlng:
    71.4041
    satalt:
    39007.8117
  11. satid:
    13016
    satname:
    SL-6 R/B(2)
    intDesignator:
    1981-123D
    launchDate:
    1981-12-23
    satlat:
    60.1832
    satlng:
    -23.2507
    satalt:
    23875.266
  12. satid:
    13169
    satname:
    SL-6 R/B(2)
    intDesignator:
    1982-029D
    launchDate:
    1982-04-07
    satlat:
    62.8167
    satlng:
    33.1428
    satalt:
    32033.7714
  13. satid:
    14189
    satname:
    OPS 9794 (NAVSTAR 8)
    intDesignator:
    1983-072A
    launchDate:
    1983-07-14
    satlat:
    63.2097
    satlng:
    75.586
    satalt:
    20458.571
  14. satid:
    14259
    satname:
    COSMOS 1491 (GLONASS)
    intDesignator:
    1983-084B
    launchDate:
    1983-08-10
    satlat:
    47.6911
    satlng:
    14.5697
    satalt:
    18970.5799
  15. satid:
    14591
    satname:
    COSMOS 1520 (GLONASS)
    intDesignator:
    1983-127B
    launchDate:
    1983-12-29
    satlat:
    63.2696
    satlng:
    14.9767
    satalt:
    19116.0594
  16. satid:
    14884
    satname:
    COSMOS 1547
    intDesignator:
    1984-033A
    launchDate:
    1984-04-04
    satlat:
    72.0049
    satlng:
    -30.5964
    satalt:
    31763.5099
  17. satid:
    15039
    satname:
    NAVSTAR 9 (USA 1)
    intDesignator:
    1984-059A
    launchDate:
    1984-06-13
    satlat:
    56.8444
    satlng:
    40.0969
    satalt:
    20297.0569
  18. satid:
    15098
    satname:
    SL-6 R/B(2)
    intDesignator:
    1984-071D
    launchDate:
    1984-07-03
    satlat:
    72.158
    satlng:
    35.9766
    satalt:
    34348.7916
  19. satid:
    15261
    satname:
    COSMOS 1595 (GLONASS)
    intDesignator:
    1984-095C
    launchDate:
    1984-09-04
    satlat:
    50.942
    satlng:
    32.4254
    satalt:
    19251.9943
  20. satid:
    15429
    satname:
    MOLNIYA 1-63
    intDesignator:
    1984-124A
    launchDate:
    1984-12-14
    satlat:
    59.6676
    satlng:
    21.2134
    satalt:
    30010.7267
  21. satid:
    15439
    satname:
    SL-6 R/B(2)
    intDesignator:
    1984-124H
    launchDate:
    1984-12-14
    satlat:
    61.8489
    satlng:
    -19.4997
    satalt:
    40405.6468
  22. satid:
    16103
    satname:
    COSMOS 1687
    intDesignator:
    1985-088A
    launchDate:
    1985-09-30
    satlat:
    72.0183
    satlng:
    31.7088
    satalt:
    18729.7416
  23. satid:
    16186
    satname:
    SL-6 R/B(2)
    intDesignator:
    1985-098D
    launchDate:
    1985-10-22
    satlat:
    69.6813
    satlng:
    47.8318
    satalt:
    18838.8395
  24. satid:
    16397
    satname:
    COSMOS 1711 (GLONASS)
    intDesignator:
    1985-118B
    launchDate:
    1985-12-24
    satlat:
    64.0505
    satlng:
    4.5535
    satalt:
    19139.4329
  25. satid:
    16402
    satname:
    SL-6 R/B(2)
    intDesignator:
    1985-117F
    launchDate:
    1985-12-24
    satlat:
    62.5153
    satlng:
    47.1377
    satalt:
    32522.4482
limit:
25
offset:
0
returned:
25
has_more_results:
yes
next_offset:
25
Will you use the result in generated code?

Open the same result as JSON

Is data missing or incorrect? Send feedback about this result.

Continue exploring

How an AI agent should use this page

Ground rule: Navigate with HTML GET links to keep explanations and relationships. Use the page's JSON alternative only when concrete values must be extracted, compared or computed.

How to use the find_satellites_above lookup

  1. Replace the placeholders in the HTML GET template; remove optional parameters you do not need.
  2. Check types, units, limits and ID formats in the parameter table.
  3. Follow linked results to canonical pages before combining sources.

Misreading to avoid: An empty list means "no results for this lookup". An error message or unavailable source does not mean the data does not exist.

Source-specific next step

Go to the source page for other operations. Use the JSON template only after the HTML result shows that the parameters and source are correct.