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-15T18:11:33Z in 0.960 seconds.

info:
category:
ANY
transactionscount:
89
satcount:
117
above:

25 results

  1. satid:
    2531
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014AK
    launchDate:
    1963-05-09
    satlat:
    67.8045
    satlng:
    25.8658
    satalt:
    3662.9563
  2. satid:
    4008
    satname:
    COSMOS 249 DEB *
    intDesignator:
    1968-091BY
    launchDate:
    1968-10-20
    satlat:
    62.2907
    satlng:
    4.6503
    satalt:
    1148.1857
  3. satid:
    4932
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025FY
    launchDate:
    1970-04-08
    satlat:
    58.4463
    satlng:
    5.403
    satalt:
    893.7827
  4. satid:
    5050
    satname:
    COSMOS 400
    intDesignator:
    1971-020A
    launchDate:
    1971-03-18
    satlat:
    58.2684
    satlng:
    5.0847
    satalt:
    1002.8977
  5. satid:
    5758
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1969-082JS
    launchDate:
    1969-09-30
    satlat:
    63.508
    satlng:
    -3.3704
    satalt:
    990.8262
  6. satid:
    7167
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086EF
    launchDate:
    1973-11-06
    satlat:
    61.2055
    satlng:
    -4.4233
    satalt:
    1485.6718
  7. satid:
    7629
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-007D
    launchDate:
    1975-01-30
    satlat:
    68.844
    satlng:
    26.2268
    satalt:
    29926.5432
  8. satid:
    7678
    satname:
    COSMOS 711
    intDesignator:
    1975-016A
    launchDate:
    1975-02-28
    satlat:
    63.8826
    satlng:
    -1.5913
    satalt:
    1474.725
  9. satid:
    8439
    satname:
    THORAD DELTA 1 DEB
    intDesignator:
    1974-089CQ
    launchDate:
    1974-11-15
    satlat:
    59.604
    satlng:
    12.4293
    satalt:
    1216.3097
  10. satid:
    8867
    satname:
    SCOUT B-1 DEB
    intDesignator:
    1976-047C
    launchDate:
    1976-05-22
    satlat:
    62.2123
    satlng:
    8.8442
    satalt:
    1093.3162
  11. satid:
    9271
    satname:
    TITAN 34B AGENA R/B
    intDesignator:
    1976-080B
    launchDate:
    1976-08-06
    satlat:
    61.3152
    satlng:
    55.9278
    satalt:
    30048.084
  12. satid:
    9982
    satname:
    TANSEI 3 DEB
    intDesignator:
    1977-012F
    launchDate:
    1977-02-19
    satlat:
    56.2411
    satlng:
    -10.0571
    satalt:
    3546.1014
  13. satid:
    10155
    satname:
    SL-6 R/B(2)
    intDesignator:
    1977-054D
    launchDate:
    1977-06-24
    satlat:
    55.4141
    satlng:
    26.6883
    satalt:
    28367.637
  14. satid:
    10893
    satname:
    OPS 5112 (NAVSTAR 2)
    intDesignator:
    1978-047A
    launchDate:
    1978-05-13
    satlat:
    41.6602
    satlng:
    -1.422
    satalt:
    18650.8129
  15. satid:
    11057
    satname:
    MOLNIYA 3-10
    intDesignator:
    1978-095A
    launchDate:
    1978-10-13
    satlat:
    63.7561
    satlng:
    2.6798
    satalt:
    13268.2206
  16. satid:
    11079
    satname:
    SL-6 R/B(2)
    intDesignator:
    1978-095E
    launchDate:
    1978-10-13
    satlat:
    63.3622
    satlng:
    36.3635
    satalt:
    34381.076
  17. satid:
    13539
    satname:
    DELTA 1 DEB
    intDesignator:
    1976-077EM
    launchDate:
    1976-07-29
    satlat:
    66.6247
    satlng:
    16.2314
    satalt:
    2160.0286
  18. satid:
    13904
    satname:
    SL-6 DEB
    intDesignator:
    1981-088G
    launchDate:
    1981-09-11
    satlat:
    46.0105
    satlng:
    -7.7385
    satalt:
    13652.3476
  19. satid:
    14894
    satname:
    SL-6 R/B(2)
    intDesignator:
    1984-033D
    launchDate:
    1984-04-04
    satlat:
    39.874
    satlng:
    -3.2172
    satalt:
    34705.4442
  20. satid:
    15272
    satname:
    ATLAS 14E R/B
    intDesignator:
    1984-097B
    launchDate:
    1984-09-08
    satlat:
    52.766
    satlng:
    6.1232
    satalt:
    14397.5119
  21. satid:
    15741
    satname:
    SL-6 R/B(2)
    intDesignator:
    1985-040D
    launchDate:
    1985-05-29
    satlat:
    59.269
    satlng:
    35.8005
    satalt:
    40190.8825
  22. satid:
    17328
    satname:
    MOLNIYA 3-31
    intDesignator:
    1987-008A
    launchDate:
    1987-01-22
    satlat:
    61.6903
    satlng:
    54.4286
    satalt:
    37154.3701
  23. satid:
    18471
    satname:
    COSMOS 839 DEB
    intDesignator:
    1976-067BN
    launchDate:
    1976-07-08
    satlat:
    65.358
    satlng:
    -4.2658
    satalt:
    1978.4809
  24. satid:
    18701
    satname:
    COSMOS 1903
    intDesignator:
    1987-105A
    launchDate:
    1987-12-21
    satlat:
    69.0237
    satlng:
    -11.9585
    satalt:
    8497.134
  25. satid:
    18943
    satname:
    COSMOS 1930
    intDesignator:
    1988-016G
    launchDate:
    1988-03-11
    satlat:
    63.6109
    satlng:
    7.6193
    satalt:
    1468.408
limit:
25
offset:
0
returned:
25
has_more_results:
yes
next_offset:
25
Show all fields in HTML
info:
category:
ANY
transactionscount:
89
satcount:
117
above:

25 results

  1. satid:
    2531
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014AK
    launchDate:
    1963-05-09
    satlat:
    67.8045
    satlng:
    25.8658
    satalt:
    3662.9563
  2. satid:
    4008
    satname:
    COSMOS 249 DEB *
    intDesignator:
    1968-091BY
    launchDate:
    1968-10-20
    satlat:
    62.2907
    satlng:
    4.6503
    satalt:
    1148.1857
  3. satid:
    4932
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025FY
    launchDate:
    1970-04-08
    satlat:
    58.4463
    satlng:
    5.403
    satalt:
    893.7827
  4. satid:
    5050
    satname:
    COSMOS 400
    intDesignator:
    1971-020A
    launchDate:
    1971-03-18
    satlat:
    58.2684
    satlng:
    5.0847
    satalt:
    1002.8977
  5. satid:
    5758
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1969-082JS
    launchDate:
    1969-09-30
    satlat:
    63.508
    satlng:
    -3.3704
    satalt:
    990.8262
  6. satid:
    7167
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086EF
    launchDate:
    1973-11-06
    satlat:
    61.2055
    satlng:
    -4.4233
    satalt:
    1485.6718
  7. satid:
    7629
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-007D
    launchDate:
    1975-01-30
    satlat:
    68.844
    satlng:
    26.2268
    satalt:
    29926.5432
  8. satid:
    7678
    satname:
    COSMOS 711
    intDesignator:
    1975-016A
    launchDate:
    1975-02-28
    satlat:
    63.8826
    satlng:
    -1.5913
    satalt:
    1474.725
  9. satid:
    8439
    satname:
    THORAD DELTA 1 DEB
    intDesignator:
    1974-089CQ
    launchDate:
    1974-11-15
    satlat:
    59.604
    satlng:
    12.4293
    satalt:
    1216.3097
  10. satid:
    8867
    satname:
    SCOUT B-1 DEB
    intDesignator:
    1976-047C
    launchDate:
    1976-05-22
    satlat:
    62.2123
    satlng:
    8.8442
    satalt:
    1093.3162
  11. satid:
    9271
    satname:
    TITAN 34B AGENA R/B
    intDesignator:
    1976-080B
    launchDate:
    1976-08-06
    satlat:
    61.3152
    satlng:
    55.9278
    satalt:
    30048.084
  12. satid:
    9982
    satname:
    TANSEI 3 DEB
    intDesignator:
    1977-012F
    launchDate:
    1977-02-19
    satlat:
    56.2411
    satlng:
    -10.0571
    satalt:
    3546.1014
  13. satid:
    10155
    satname:
    SL-6 R/B(2)
    intDesignator:
    1977-054D
    launchDate:
    1977-06-24
    satlat:
    55.4141
    satlng:
    26.6883
    satalt:
    28367.637
  14. satid:
    10893
    satname:
    OPS 5112 (NAVSTAR 2)
    intDesignator:
    1978-047A
    launchDate:
    1978-05-13
    satlat:
    41.6602
    satlng:
    -1.422
    satalt:
    18650.8129
  15. satid:
    11057
    satname:
    MOLNIYA 3-10
    intDesignator:
    1978-095A
    launchDate:
    1978-10-13
    satlat:
    63.7561
    satlng:
    2.6798
    satalt:
    13268.2206
  16. satid:
    11079
    satname:
    SL-6 R/B(2)
    intDesignator:
    1978-095E
    launchDate:
    1978-10-13
    satlat:
    63.3622
    satlng:
    36.3635
    satalt:
    34381.076
  17. satid:
    13539
    satname:
    DELTA 1 DEB
    intDesignator:
    1976-077EM
    launchDate:
    1976-07-29
    satlat:
    66.6247
    satlng:
    16.2314
    satalt:
    2160.0286
  18. satid:
    13904
    satname:
    SL-6 DEB
    intDesignator:
    1981-088G
    launchDate:
    1981-09-11
    satlat:
    46.0105
    satlng:
    -7.7385
    satalt:
    13652.3476
  19. satid:
    14894
    satname:
    SL-6 R/B(2)
    intDesignator:
    1984-033D
    launchDate:
    1984-04-04
    satlat:
    39.874
    satlng:
    -3.2172
    satalt:
    34705.4442
  20. satid:
    15272
    satname:
    ATLAS 14E R/B
    intDesignator:
    1984-097B
    launchDate:
    1984-09-08
    satlat:
    52.766
    satlng:
    6.1232
    satalt:
    14397.5119
  21. satid:
    15741
    satname:
    SL-6 R/B(2)
    intDesignator:
    1985-040D
    launchDate:
    1985-05-29
    satlat:
    59.269
    satlng:
    35.8005
    satalt:
    40190.8825
  22. satid:
    17328
    satname:
    MOLNIYA 3-31
    intDesignator:
    1987-008A
    launchDate:
    1987-01-22
    satlat:
    61.6903
    satlng:
    54.4286
    satalt:
    37154.3701
  23. satid:
    18471
    satname:
    COSMOS 839 DEB
    intDesignator:
    1976-067BN
    launchDate:
    1976-07-08
    satlat:
    65.358
    satlng:
    -4.2658
    satalt:
    1978.4809
  24. satid:
    18701
    satname:
    COSMOS 1903
    intDesignator:
    1987-105A
    launchDate:
    1987-12-21
    satlat:
    69.0237
    satlng:
    -11.9585
    satalt:
    8497.134
  25. satid:
    18943
    satname:
    COSMOS 1930
    intDesignator:
    1988-016G
    launchDate:
    1988-03-11
    satlat:
    63.6109
    satlng:
    7.6193
    satalt:
    1468.408
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.