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-16T17:20:49Z in 1.825 seconds.

info:
category:
ANY
transactionscount:
87
satcount:
113
above:

25 results

  1. satid:
    2403
    satname:
    OPS 0856
    intDesignator:
    1966-077A
    launchDate:
    1966-08-19
    satlat:
    60.8235
    satlng:
    -8.1754
    satalt:
    3697.1644
  2. satid:
    2701
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1965-048E
    launchDate:
    1965-06-24
    satlat:
    65.6292
    satlng:
    0.683
    satalt:
    1077.5974
  3. satid:
    6154
    satname:
    COSMOS 516
    intDesignator:
    1972-066A
    launchDate:
    1972-08-21
    satlat:
    63.3406
    satlng:
    19.9111
    satalt:
    945.8279
  4. satid:
    6167
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025NB
    launchDate:
    1970-04-08
    satlat:
    61.6437
    satlng:
    10.607
    satalt:
    995.6952
  5. satid:
    7629
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-007D
    launchDate:
    1975-01-30
    satlat:
    67.3526
    satlng:
    7.7531
    satalt:
    26658.414
  6. satid:
    7681
    satname:
    COSMOS 714
    intDesignator:
    1975-016D
    launchDate:
    1975-02-28
    satlat:
    67.2225
    satlng:
    6.5127
    satalt:
    1497.1986
  7. satid:
    9983
    satname:
    TANSEI 3 DEB
    intDesignator:
    1977-012G
    launchDate:
    1977-02-19
    satlat:
    62.1407
    satlng:
    7.277
    satalt:
    3135.8911
  8. satid:
    11057
    satname:
    MOLNIYA 3-10
    intDesignator:
    1978-095A
    launchDate:
    1978-10-13
    satlat:
    62.1266
    satlng:
    -9.52
    satalt:
    11016.1364
  9. satid:
    12446
    satname:
    TITAN 34B R/B
    intDesignator:
    1981-038B
    launchDate:
    1981-04-24
    satlat:
    62.7122
    satlng:
    35.6041
    satalt:
    15913.0099
  10. satid:
    12659
    satname:
    COSMOS 1275 DEB
    intDesignator:
    1981-053P
    launchDate:
    1981-06-04
    satlat:
    62.9542
    satlng:
    7.1056
    satalt:
    953.2739
  11. satid:
    12962
    satname:
    COSMOS 1275 DEB
    intDesignator:
    1981-053EH
    launchDate:
    1981-06-04
    satlat:
    63.325
    satlng:
    6.3617
    satalt:
    881.1054
  12. satid:
    13020
    satname:
    COSMOS 1275 DEB
    intDesignator:
    1981-053ES
    launchDate:
    1981-06-04
    satlat:
    62.587
    satlng:
    7.9824
    satalt:
    932.5805
  13. satid:
    14401
    satname:
    COSMOS 1503
    intDesignator:
    1983-103A
    launchDate:
    1983-10-12
    satlat:
    65.3726
    satlng:
    4.5811
    satalt:
    792.5617
  14. satid:
    15741
    satname:
    SL-6 R/B(2)
    intDesignator:
    1985-040D
    launchDate:
    1985-05-29
    satlat:
    55.1926
    satlng:
    33.7818
    satalt:
    37815.1237
  15. satid:
    17328
    satname:
    MOLNIYA 3-31
    intDesignator:
    1987-008A
    launchDate:
    1987-01-22
    satlat:
    61.8349
    satlng:
    53.9915
    satalt:
    38920.2765
  16. satid:
    18949
    satname:
    SL-6 R/B(2)
    intDesignator:
    1988-017D
    launchDate:
    1988-03-11
    satlat:
    61.8721
    satlng:
    -28.8925
    satalt:
    37497.3927
  17. satid:
    19807
    satname:
    MOLNIYA 1-75
    intDesignator:
    1989-014A
    launchDate:
    1989-02-15
    satlat:
    61.5739
    satlng:
    -44.6219
    satalt:
    30081.2511
  18. satid:
    20061
    satname:
    NAVSTAR 14 (USA 38)
    intDesignator:
    1989-044A
    launchDate:
    1989-06-10
    satlat:
    49.7542
    satlng:
    11.5181
    satalt:
    21335.5552
  19. satid:
    20891
    satname:
    CZ-4 DEB
    intDesignator:
    1990-081BB
    launchDate:
    1990-09-03
    satlat:
    60.341
    satlng:
    8.9769
    satalt:
    1096.3495
  20. satid:
    21029
    satname:
    COSMOS 2115
    intDesignator:
    1990-114B
    launchDate:
    1990-12-22
    satlat:
    62.6662
    satlng:
    13.9702
    satalt:
    1421.3588
  21. satid:
    21121
    satname:
    SL-6 R/B(2)
    intDesignator:
    1991-012D
    launchDate:
    1991-02-15
    satlat:
    64.6181
    satlng:
    -37.259
    satalt:
    32495.9338
  22. satid:
    21171
    satname:
    SL-8 DEB
    intDesignator:
    1991-009AJ
    launchDate:
    1991-02-12
    satlat:
    67.9138
    satlng:
    6.4168
    satalt:
    1570.9942
  23. satid:
    21172
    satname:
    SL-8 DEB
    intDesignator:
    1991-009AK
    launchDate:
    1991-02-12
    satlat:
    65.2288
    satlng:
    5.107
    satalt:
    1551.187
  24. satid:
    21341
    satname:
    DELTA 1 DEB
    intDesignator:
    1975-052BK
    launchDate:
    1975-06-12
    satlat:
    60.8483
    satlng:
    12.5127
    satalt:
    1408.4163
  25. satid:
    21400
    satname:
    SL-8 DEB
    intDesignator:
    1991-009BP
    launchDate:
    1991-02-12
    satlat:
    68.456
    satlng:
    6.8704
    satalt:
    1668.22
limit:
25
offset:
0
returned:
25
has_more_results:
yes
next_offset:
25
Show all fields in HTML
info:
category:
ANY
transactionscount:
87
satcount:
113
above:

25 results

  1. satid:
    2403
    satname:
    OPS 0856
    intDesignator:
    1966-077A
    launchDate:
    1966-08-19
    satlat:
    60.8235
    satlng:
    -8.1754
    satalt:
    3697.1644
  2. satid:
    2701
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1965-048E
    launchDate:
    1965-06-24
    satlat:
    65.6292
    satlng:
    0.683
    satalt:
    1077.5974
  3. satid:
    6154
    satname:
    COSMOS 516
    intDesignator:
    1972-066A
    launchDate:
    1972-08-21
    satlat:
    63.3406
    satlng:
    19.9111
    satalt:
    945.8279
  4. satid:
    6167
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025NB
    launchDate:
    1970-04-08
    satlat:
    61.6437
    satlng:
    10.607
    satalt:
    995.6952
  5. satid:
    7629
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-007D
    launchDate:
    1975-01-30
    satlat:
    67.3526
    satlng:
    7.7531
    satalt:
    26658.414
  6. satid:
    7681
    satname:
    COSMOS 714
    intDesignator:
    1975-016D
    launchDate:
    1975-02-28
    satlat:
    67.2225
    satlng:
    6.5127
    satalt:
    1497.1986
  7. satid:
    9983
    satname:
    TANSEI 3 DEB
    intDesignator:
    1977-012G
    launchDate:
    1977-02-19
    satlat:
    62.1407
    satlng:
    7.277
    satalt:
    3135.8911
  8. satid:
    11057
    satname:
    MOLNIYA 3-10
    intDesignator:
    1978-095A
    launchDate:
    1978-10-13
    satlat:
    62.1266
    satlng:
    -9.52
    satalt:
    11016.1364
  9. satid:
    12446
    satname:
    TITAN 34B R/B
    intDesignator:
    1981-038B
    launchDate:
    1981-04-24
    satlat:
    62.7122
    satlng:
    35.6041
    satalt:
    15913.0099
  10. satid:
    12659
    satname:
    COSMOS 1275 DEB
    intDesignator:
    1981-053P
    launchDate:
    1981-06-04
    satlat:
    62.9542
    satlng:
    7.1056
    satalt:
    953.2739
  11. satid:
    12962
    satname:
    COSMOS 1275 DEB
    intDesignator:
    1981-053EH
    launchDate:
    1981-06-04
    satlat:
    63.325
    satlng:
    6.3617
    satalt:
    881.1054
  12. satid:
    13020
    satname:
    COSMOS 1275 DEB
    intDesignator:
    1981-053ES
    launchDate:
    1981-06-04
    satlat:
    62.587
    satlng:
    7.9824
    satalt:
    932.5805
  13. satid:
    14401
    satname:
    COSMOS 1503
    intDesignator:
    1983-103A
    launchDate:
    1983-10-12
    satlat:
    65.3726
    satlng:
    4.5811
    satalt:
    792.5617
  14. satid:
    15741
    satname:
    SL-6 R/B(2)
    intDesignator:
    1985-040D
    launchDate:
    1985-05-29
    satlat:
    55.1926
    satlng:
    33.7818
    satalt:
    37815.1237
  15. satid:
    17328
    satname:
    MOLNIYA 3-31
    intDesignator:
    1987-008A
    launchDate:
    1987-01-22
    satlat:
    61.8349
    satlng:
    53.9915
    satalt:
    38920.2765
  16. satid:
    18949
    satname:
    SL-6 R/B(2)
    intDesignator:
    1988-017D
    launchDate:
    1988-03-11
    satlat:
    61.8721
    satlng:
    -28.8925
    satalt:
    37497.3927
  17. satid:
    19807
    satname:
    MOLNIYA 1-75
    intDesignator:
    1989-014A
    launchDate:
    1989-02-15
    satlat:
    61.5739
    satlng:
    -44.6219
    satalt:
    30081.2511
  18. satid:
    20061
    satname:
    NAVSTAR 14 (USA 38)
    intDesignator:
    1989-044A
    launchDate:
    1989-06-10
    satlat:
    49.7542
    satlng:
    11.5181
    satalt:
    21335.5552
  19. satid:
    20891
    satname:
    CZ-4 DEB
    intDesignator:
    1990-081BB
    launchDate:
    1990-09-03
    satlat:
    60.341
    satlng:
    8.9769
    satalt:
    1096.3495
  20. satid:
    21029
    satname:
    COSMOS 2115
    intDesignator:
    1990-114B
    launchDate:
    1990-12-22
    satlat:
    62.6662
    satlng:
    13.9702
    satalt:
    1421.3588
  21. satid:
    21121
    satname:
    SL-6 R/B(2)
    intDesignator:
    1991-012D
    launchDate:
    1991-02-15
    satlat:
    64.6181
    satlng:
    -37.259
    satalt:
    32495.9338
  22. satid:
    21171
    satname:
    SL-8 DEB
    intDesignator:
    1991-009AJ
    launchDate:
    1991-02-12
    satlat:
    67.9138
    satlng:
    6.4168
    satalt:
    1570.9942
  23. satid:
    21172
    satname:
    SL-8 DEB
    intDesignator:
    1991-009AK
    launchDate:
    1991-02-12
    satlat:
    65.2288
    satlng:
    5.107
    satalt:
    1551.187
  24. satid:
    21341
    satname:
    DELTA 1 DEB
    intDesignator:
    1975-052BK
    launchDate:
    1975-06-12
    satlat:
    60.8483
    satlng:
    12.5127
    satalt:
    1408.4163
  25. satid:
    21400
    satname:
    SL-8 DEB
    intDesignator:
    1991-009BP
    launchDate:
    1991-02-12
    satlat:
    68.456
    satlng:
    6.8704
    satalt:
    1668.22
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.