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-27T04:05:15Z in 0.715 seconds.

info:
category:
ANY
transactionscount:
39
satcount:
141
above:

25 results

  1. satid:
    728
    satname:
    GGSE 1 (GGRS)
    intDesignator:
    1964-001B
    launchDate:
    1964-01-11
    satlat:
    69.1848
    satlng:
    23.5251
    satalt:
    919.7444
  2. satid:
    902
    satname:
    CALSPHERE 2
    intDesignator:
    1964-063E
    launchDate:
    1964-10-06
    satlat:
    68.572
    satlng:
    10.3318
    satalt:
    1082.3123
  3. satid:
    2367
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014S
    launchDate:
    1963-05-09
    satlat:
    77.7938
    satlng:
    -8.2736
    satalt:
    3526.992
  4. satid:
    4982
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025HC
    launchDate:
    1970-04-08
    satlat:
    65.1317
    satlng:
    21.257
    satalt:
    1107.1133
  5. satid:
    5054
    satname:
    TITAN 34B AGENA D R/B
    intDesignator:
    1971-021B
    launchDate:
    1971-03-21
    satlat:
    63.5399
    satlng:
    17.1965
    satalt:
    36680.4434
  6. satid:
    5217
    satname:
    COSMOS 418
    intDesignator:
    1971-041H
    launchDate:
    1971-05-07
    satlat:
    71.9692
    satlng:
    6.557
    satalt:
    1412.6463
  7. satid:
    5359
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025KQ
    launchDate:
    1970-04-08
    satlat:
    69.3929
    satlng:
    18.5798
    satalt:
    994.3247
  8. satid:
    6125
    satname:
    SL-8 R/B
    intDesignator:
    1972-057J
    launchDate:
    1972-07-20
    satlat:
    67.4345
    satlng:
    12.7456
    satalt:
    1504.7195
  9. satid:
    6197
    satname:
    EXPLORER 47 (IMP-7)
    intDesignator:
    1972-073A
    launchDate:
    1972-09-23
    satlat:
    58.1593
    satlng:
    43.5748
    satalt:
    229388.618
  10. satid:
    7023
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086P
    launchDate:
    1973-11-06
    satlat:
    65.1699
    satlng:
    26.6407
    satalt:
    1529.3753
  11. satid:
    7079
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086BX
    launchDate:
    1973-11-06
    satlat:
    65.216
    satlng:
    12.5609
    satalt:
    1545.5397
  12. satid:
    7276
    satname:
    MOLNIYA 2-9
    intDesignator:
    1974-026A
    launchDate:
    1974-04-26
    satlat:
    57.5777
    satlng:
    -15.0322
    satalt:
    30678.4001
  13. satid:
    8018
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-063D
    launchDate:
    1975-07-08
    satlat:
    55.278
    satlng:
    -1.4086
    satalt:
    29122.0001
  14. satid:
    8310
    satname:
    THORAD DELTA 1 DEB
    intDesignator:
    1974-089BT
    launchDate:
    1974-11-15
    satlat:
    68.5983
    satlng:
    28.4036
    satalt:
    1507.7946
  15. satid:
    8435
    satname:
    THORAD DELTA 1 DEB
    intDesignator:
    1974-089CL
    launchDate:
    1974-11-15
    satlat:
    74.2641
    satlng:
    12.9651
    satalt:
    1603.4295
  16. satid:
    9843
    satname:
    TANSEI 3 DEB
    intDesignator:
    1977-012C
    launchDate:
    1977-02-19
    satlat:
    65.069
    satlng:
    21.7154
    satalt:
    3618.286
  17. satid:
    10586
    satname:
    COSMOS 979
    intDesignator:
    1978-005D
    launchDate:
    1978-01-10
    satlat:
    64.5556
    satlng:
    11.3345
    satalt:
    1464.654
  18. satid:
    10875
    satname:
    DELTA 1 DEB
    intDesignator:
    1976-077DD
    launchDate:
    1976-07-29
    satlat:
    67.224
    satlng:
    7.6101
    satalt:
    1479.5341
  19. satid:
    11690
    satname:
    OPS 5117 (NAVSTAR 5)
    intDesignator:
    1980-011A
    launchDate:
    1980-02-09
    satlat:
    63.1916
    satlng:
    46.2358
    satalt:
    20887.9251
  20. satid:
    12730
    satname:
    COSMOS 1275 DEB
    intDesignator:
    1981-053BX
    launchDate:
    1981-06-04
    satlat:
    71.1828
    satlng:
    20.4044
    satalt:
    769.5607
  21. satid:
    12815
    satname:
    COSMOS 931 DEB
    intDesignator:
    1977-068E
    launchDate:
    1977-07-20
    satlat:
    48.3055
    satlng:
    2.1837
    satalt:
    33437.5467
  22. satid:
    12818
    satname:
    COSMOS 1305
    intDesignator:
    1981-088A
    launchDate:
    1981-09-11
    satlat:
    60.6774
    satlng:
    -18.0893
    satalt:
    13743.195
  23. satid:
    12984
    satname:
    COSMOS 1247 DEB
    intDesignator:
    1981-016F
    launchDate:
    1981-02-19
    satlat:
    69.7695
    satlng:
    20.9402
    satalt:
    15606.3704
  24. satid:
    13012
    satname:
    MOLNIYA 1-52
    intDesignator:
    1981-123A
    launchDate:
    1981-12-23
    satlat:
    61.7829
    satlng:
    75.6472
    satalt:
    38904.7416
  25. satid:
    13573
    satname:
    DELTA 1 DEB
    intDesignator:
    1978-026FL
    launchDate:
    1978-03-05
    satlat:
    71.7549
    satlng:
    23.7282
    satalt:
    932.834
limit:
25
offset:
0
returned:
25
has_more_results:
yes
truncated:
yes
next_offset:
25
Show all fields in HTML
info:
category:
ANY
transactionscount:
39
satcount:
141
above:

25 results

  1. satid:
    728
    satname:
    GGSE 1 (GGRS)
    intDesignator:
    1964-001B
    launchDate:
    1964-01-11
    satlat:
    69.1848
    satlng:
    23.5251
    satalt:
    919.7444
  2. satid:
    902
    satname:
    CALSPHERE 2
    intDesignator:
    1964-063E
    launchDate:
    1964-10-06
    satlat:
    68.572
    satlng:
    10.3318
    satalt:
    1082.3123
  3. satid:
    2367
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014S
    launchDate:
    1963-05-09
    satlat:
    77.7938
    satlng:
    -8.2736
    satalt:
    3526.992
  4. satid:
    4982
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025HC
    launchDate:
    1970-04-08
    satlat:
    65.1317
    satlng:
    21.257
    satalt:
    1107.1133
  5. satid:
    5054
    satname:
    TITAN 34B AGENA D R/B
    intDesignator:
    1971-021B
    launchDate:
    1971-03-21
    satlat:
    63.5399
    satlng:
    17.1965
    satalt:
    36680.4434
  6. satid:
    5217
    satname:
    COSMOS 418
    intDesignator:
    1971-041H
    launchDate:
    1971-05-07
    satlat:
    71.9692
    satlng:
    6.557
    satalt:
    1412.6463
  7. satid:
    5359
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025KQ
    launchDate:
    1970-04-08
    satlat:
    69.3929
    satlng:
    18.5798
    satalt:
    994.3247
  8. satid:
    6125
    satname:
    SL-8 R/B
    intDesignator:
    1972-057J
    launchDate:
    1972-07-20
    satlat:
    67.4345
    satlng:
    12.7456
    satalt:
    1504.7195
  9. satid:
    6197
    satname:
    EXPLORER 47 (IMP-7)
    intDesignator:
    1972-073A
    launchDate:
    1972-09-23
    satlat:
    58.1593
    satlng:
    43.5748
    satalt:
    229388.618
  10. satid:
    7023
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086P
    launchDate:
    1973-11-06
    satlat:
    65.1699
    satlng:
    26.6407
    satalt:
    1529.3753
  11. satid:
    7079
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086BX
    launchDate:
    1973-11-06
    satlat:
    65.216
    satlng:
    12.5609
    satalt:
    1545.5397
  12. satid:
    7276
    satname:
    MOLNIYA 2-9
    intDesignator:
    1974-026A
    launchDate:
    1974-04-26
    satlat:
    57.5777
    satlng:
    -15.0322
    satalt:
    30678.4001
  13. satid:
    8018
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-063D
    launchDate:
    1975-07-08
    satlat:
    55.278
    satlng:
    -1.4086
    satalt:
    29122.0001
  14. satid:
    8310
    satname:
    THORAD DELTA 1 DEB
    intDesignator:
    1974-089BT
    launchDate:
    1974-11-15
    satlat:
    68.5983
    satlng:
    28.4036
    satalt:
    1507.7946
  15. satid:
    8435
    satname:
    THORAD DELTA 1 DEB
    intDesignator:
    1974-089CL
    launchDate:
    1974-11-15
    satlat:
    74.2641
    satlng:
    12.9651
    satalt:
    1603.4295
  16. satid:
    9843
    satname:
    TANSEI 3 DEB
    intDesignator:
    1977-012C
    launchDate:
    1977-02-19
    satlat:
    65.069
    satlng:
    21.7154
    satalt:
    3618.286
  17. satid:
    10586
    satname:
    COSMOS 979
    intDesignator:
    1978-005D
    launchDate:
    1978-01-10
    satlat:
    64.5556
    satlng:
    11.3345
    satalt:
    1464.654
  18. satid:
    10875
    satname:
    DELTA 1 DEB
    intDesignator:
    1976-077DD
    launchDate:
    1976-07-29
    satlat:
    67.224
    satlng:
    7.6101
    satalt:
    1479.5341
  19. satid:
    11690
    satname:
    OPS 5117 (NAVSTAR 5)
    intDesignator:
    1980-011A
    launchDate:
    1980-02-09
    satlat:
    63.1916
    satlng:
    46.2358
    satalt:
    20887.9251
  20. satid:
    12730
    satname:
    COSMOS 1275 DEB
    intDesignator:
    1981-053BX
    launchDate:
    1981-06-04
    satlat:
    71.1828
    satlng:
    20.4044
    satalt:
    769.5607
  21. satid:
    12815
    satname:
    COSMOS 931 DEB
    intDesignator:
    1977-068E
    launchDate:
    1977-07-20
    satlat:
    48.3055
    satlng:
    2.1837
    satalt:
    33437.5467
  22. satid:
    12818
    satname:
    COSMOS 1305
    intDesignator:
    1981-088A
    launchDate:
    1981-09-11
    satlat:
    60.6774
    satlng:
    -18.0893
    satalt:
    13743.195
  23. satid:
    12984
    satname:
    COSMOS 1247 DEB
    intDesignator:
    1981-016F
    launchDate:
    1981-02-19
    satlat:
    69.7695
    satlng:
    20.9402
    satalt:
    15606.3704
  24. satid:
    13012
    satname:
    MOLNIYA 1-52
    intDesignator:
    1981-123A
    launchDate:
    1981-12-23
    satlat:
    61.7829
    satlng:
    75.6472
    satalt:
    38904.7416
  25. satid:
    13573
    satname:
    DELTA 1 DEB
    intDesignator:
    1978-026FL
    launchDate:
    1978-03-05
    satlat:
    71.7549
    satlng:
    23.7282
    satalt:
    932.834
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.