Allemannsdata Wiki
Manual search

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-09-25T04:10:33Z in 1.459 seconds.

info:
category:
ANY
transactionscount:
51
satcount:
138
above:

25 results

  1. satid:
    158
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1961-015AU
    launchDate:
    1961-06-29
    satlat:
    65.1442
    satlng:
    16.1502
    satalt:
    1493.3745
  2. satid:
    902
    satname:
    CALSPHERE 2
    intDesignator:
    1964-063E
    launchDate:
    1964-10-06
    satlat:
    71.3701
    satlng:
    10.8331
    satalt:
    1082.2333
  3. satid:
    2380
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014AA
    launchDate:
    1963-05-09
    satlat:
    70.5828
    satlng:
    8.8113
    satalt:
    3044.9868
  4. satid:
    2796
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014AQ
    launchDate:
    1963-05-09
    satlat:
    68.011
    satlng:
    16.6741
    satalt:
    3021.4563
  5. satid:
    5685
    satname:
    SL-8 R/B
    intDesignator:
    1971-111B
    launchDate:
    1971-12-15
    satlat:
    72.1529
    satlng:
    15.4657
    satalt:
    970.0317
  6. satid:
    5698
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025MD
    launchDate:
    1970-04-08
    satlat:
    65.6511
    satlng:
    23.5381
    satalt:
    1041.3146
  7. satid:
    6237
    satname:
    DELTA 1 R/B
    intDesignator:
    1972-082C
    launchDate:
    1972-10-15
    satlat:
    68.3025
    satlng:
    25.6302
    satalt:
    1385.7562
  8. satid:
    6678
    satname:
    COSMOS 567
    intDesignator:
    1973-037D
    launchDate:
    1973-06-08
    satlat:
    73.6685
    satlng:
    21.1996
    satalt:
    1462.722
  9. satid:
    7135
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086CZ
    launchDate:
    1973-11-06
    satlat:
    66.7372
    satlng:
    27.1731
    satalt:
    1441.994
  10. satid:
    7160
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086DY
    launchDate:
    1973-11-06
    satlat:
    71.0338
    satlng:
    23.5454
    satalt:
    1510.9803
  11. satid:
    7276
    satname:
    MOLNIYA 2-9
    intDesignator:
    1974-026A
    launchDate:
    1974-04-26
    satlat:
    62.6535
    satlng:
    4.856
    satalt:
    32408.0521
  12. satid:
    8168
    satname:
    THORAD DELTA 1 DEB
    intDesignator:
    1974-089AJ
    launchDate:
    1974-11-15
    satlat:
    72.3028
    satlng:
    31.0321
    satalt:
    1448.8134
  13. satid:
    8195
    satname:
    MOLNIYA 2-14
    intDesignator:
    1975-081A
    launchDate:
    1975-09-09
    satlat:
    61.0792
    satlng:
    77.8009
    satalt:
    38061.253
  14. satid:
    10569
    satname:
    COSMOS 970 DEB
    intDesignator:
    1977-121L
    launchDate:
    1977-12-21
    satlat:
    65.2241
    satlng:
    19.7705
    satalt:
    921.9015
  15. satid:
    10751
    satname:
    DELTA 1 DEB
    intDesignator:
    1976-077AY
    launchDate:
    1976-07-29
    satlat:
    73.8693
    satlng:
    32.5632
    satalt:
    2082.8587
  16. satid:
    11681
    satname:
    SL-8 R/B
    intDesignator:
    1980-007B
    launchDate:
    1980-01-25
    satlat:
    69.8116
    satlng:
    12.0947
    satalt:
    1016.712
  17. satid:
    11690
    satname:
    OPS 5117 (NAVSTAR 5)
    intDesignator:
    1980-011A
    launchDate:
    1980-02-09
    satlat:
    62.6842
    satlng:
    44.0802
    satalt:
    20915.2943
  18. satid:
    12323
    satname:
    COSMOS 1253
    intDesignator:
    1981-022D
    launchDate:
    1981-03-06
    satlat:
    71.6952
    satlng:
    2.9823
    satalt:
    1508.4744
  19. satid:
    12815
    satname:
    COSMOS 931 DEB
    intDesignator:
    1977-068E
    launchDate:
    1977-07-20
    satlat:
    50.0937
    satlng:
    1.0758
    satalt:
    32884.5895
  20. satid:
    12818
    satname:
    COSMOS 1305
    intDesignator:
    1981-088A
    launchDate:
    1981-09-11
    satlat:
    53.3264
    satlng:
    6.1712
    satalt:
    12599.4905
  21. satid:
    13012
    satname:
    MOLNIYA 1-52
    intDesignator:
    1981-123A
    launchDate:
    1981-12-23
    satlat:
    61.7853
    satlng:
    76.2224
    satalt:
    38863.1087
  22. satid:
    13603
    satname:
    COSMOS 1413 (GLONASS)
    intDesignator:
    1982-100A
    launchDate:
    1982-10-12
    satlat:
    61.0226
    satlng:
    54.2601
    satalt:
    19064.9535
  23. satid:
    13799
    satname:
    COSMOS 1275 DEB
    intDesignator:
    1981-053GW
    launchDate:
    1981-06-04
    satlat:
    71.9263
    satlng:
    10.151
    satalt:
    981.398
  24. satid:
    13959
    satname:
    COSMOS 1030 DEB
    intDesignator:
    1978-083G
    launchDate:
    1978-09-06
    satlat:
    67.3084
    satlng:
    24.5717
    satalt:
    23460.188
  25. satid:
    14179
    satname:
    SL-8 R/B
    intDesignator:
    1983-069J
    launchDate:
    1983-07-06
    satlat:
    65.609
    satlng:
    4.5147
    satalt:
    1662.923
limit:
25
offset:
0
returned:
25
has_more_results:
yes
truncated:
yes
next_offset:
25
Show all fields in HTML
info:
category:
ANY
transactionscount:
51
satcount:
138
above:

25 results

  1. satid:
    158
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1961-015AU
    launchDate:
    1961-06-29
    satlat:
    65.1442
    satlng:
    16.1502
    satalt:
    1493.3745
  2. satid:
    902
    satname:
    CALSPHERE 2
    intDesignator:
    1964-063E
    launchDate:
    1964-10-06
    satlat:
    71.3701
    satlng:
    10.8331
    satalt:
    1082.2333
  3. satid:
    2380
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014AA
    launchDate:
    1963-05-09
    satlat:
    70.5828
    satlng:
    8.8113
    satalt:
    3044.9868
  4. satid:
    2796
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014AQ
    launchDate:
    1963-05-09
    satlat:
    68.011
    satlng:
    16.6741
    satalt:
    3021.4563
  5. satid:
    5685
    satname:
    SL-8 R/B
    intDesignator:
    1971-111B
    launchDate:
    1971-12-15
    satlat:
    72.1529
    satlng:
    15.4657
    satalt:
    970.0317
  6. satid:
    5698
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025MD
    launchDate:
    1970-04-08
    satlat:
    65.6511
    satlng:
    23.5381
    satalt:
    1041.3146
  7. satid:
    6237
    satname:
    DELTA 1 R/B
    intDesignator:
    1972-082C
    launchDate:
    1972-10-15
    satlat:
    68.3025
    satlng:
    25.6302
    satalt:
    1385.7562
  8. satid:
    6678
    satname:
    COSMOS 567
    intDesignator:
    1973-037D
    launchDate:
    1973-06-08
    satlat:
    73.6685
    satlng:
    21.1996
    satalt:
    1462.722
  9. satid:
    7135
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086CZ
    launchDate:
    1973-11-06
    satlat:
    66.7372
    satlng:
    27.1731
    satalt:
    1441.994
  10. satid:
    7160
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086DY
    launchDate:
    1973-11-06
    satlat:
    71.0338
    satlng:
    23.5454
    satalt:
    1510.9803
  11. satid:
    7276
    satname:
    MOLNIYA 2-9
    intDesignator:
    1974-026A
    launchDate:
    1974-04-26
    satlat:
    62.6535
    satlng:
    4.856
    satalt:
    32408.0521
  12. satid:
    8168
    satname:
    THORAD DELTA 1 DEB
    intDesignator:
    1974-089AJ
    launchDate:
    1974-11-15
    satlat:
    72.3028
    satlng:
    31.0321
    satalt:
    1448.8134
  13. satid:
    8195
    satname:
    MOLNIYA 2-14
    intDesignator:
    1975-081A
    launchDate:
    1975-09-09
    satlat:
    61.0792
    satlng:
    77.8009
    satalt:
    38061.253
  14. satid:
    10569
    satname:
    COSMOS 970 DEB
    intDesignator:
    1977-121L
    launchDate:
    1977-12-21
    satlat:
    65.2241
    satlng:
    19.7705
    satalt:
    921.9015
  15. satid:
    10751
    satname:
    DELTA 1 DEB
    intDesignator:
    1976-077AY
    launchDate:
    1976-07-29
    satlat:
    73.8693
    satlng:
    32.5632
    satalt:
    2082.8587
  16. satid:
    11681
    satname:
    SL-8 R/B
    intDesignator:
    1980-007B
    launchDate:
    1980-01-25
    satlat:
    69.8116
    satlng:
    12.0947
    satalt:
    1016.712
  17. satid:
    11690
    satname:
    OPS 5117 (NAVSTAR 5)
    intDesignator:
    1980-011A
    launchDate:
    1980-02-09
    satlat:
    62.6842
    satlng:
    44.0802
    satalt:
    20915.2943
  18. satid:
    12323
    satname:
    COSMOS 1253
    intDesignator:
    1981-022D
    launchDate:
    1981-03-06
    satlat:
    71.6952
    satlng:
    2.9823
    satalt:
    1508.4744
  19. satid:
    12815
    satname:
    COSMOS 931 DEB
    intDesignator:
    1977-068E
    launchDate:
    1977-07-20
    satlat:
    50.0937
    satlng:
    1.0758
    satalt:
    32884.5895
  20. satid:
    12818
    satname:
    COSMOS 1305
    intDesignator:
    1981-088A
    launchDate:
    1981-09-11
    satlat:
    53.3264
    satlng:
    6.1712
    satalt:
    12599.4905
  21. satid:
    13012
    satname:
    MOLNIYA 1-52
    intDesignator:
    1981-123A
    launchDate:
    1981-12-23
    satlat:
    61.7853
    satlng:
    76.2224
    satalt:
    38863.1087
  22. satid:
    13603
    satname:
    COSMOS 1413 (GLONASS)
    intDesignator:
    1982-100A
    launchDate:
    1982-10-12
    satlat:
    61.0226
    satlng:
    54.2601
    satalt:
    19064.9535
  23. satid:
    13799
    satname:
    COSMOS 1275 DEB
    intDesignator:
    1981-053GW
    launchDate:
    1981-06-04
    satlat:
    71.9263
    satlng:
    10.151
    satalt:
    981.398
  24. satid:
    13959
    satname:
    COSMOS 1030 DEB
    intDesignator:
    1978-083G
    launchDate:
    1978-09-06
    satlat:
    67.3084
    satlng:
    24.5717
    satalt:
    23460.188
  25. satid:
    14179
    satname:
    SL-8 R/B
    intDesignator:
    1983-069J
    launchDate:
    1983-07-06
    satlat:
    65.609
    satlng:
    4.5147
    satalt:
    1662.923
limit:
25
offset:
0
returned:
25
has_more_results:
yes
truncated:
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.

AI agent? Read the complete navigation and programming guide.