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-10-17T23:41:13Z in 1.302 seconds.

info:
category:
ANY
transactionscount:
84
satcount:
127
above:

25 results

  1. satid:
    2367
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014S
    launchDate:
    1963-05-09
    satlat:
    54.1779
    satlng:
    11.0518
    satalt:
    3671.8389
  2. satid:
    2435
    satname:
    ESSA 3 (TOS-A)
    intDesignator:
    1966-087A
    launchDate:
    1966-10-02
    satlat:
    56.7322
    satlng:
    1.7654
    satalt:
    1402.1197
  3. satid:
    3555
    satname:
    COSMOS 252 DEB
    intDesignator:
    1968-097H
    launchDate:
    1968-11-01
    satlat:
    61.156
    satlng:
    10.3045
    satalt:
    1521.6613
  4. satid:
    3790
    satname:
    COSMOS 249 DEB *
    intDesignator:
    1968-091AX
    launchDate:
    1968-10-20
    satlat:
    56.9212
    satlng:
    18.2767
    satalt:
    1195.1063
  5. satid:
    3794
    satname:
    COSMOS 249 DEB
    intDesignator:
    1968-091BB
    launchDate:
    1968-10-20
    satlat:
    58.8106
    satlng:
    16.4419
    satalt:
    1531.7156
  6. satid:
    3810
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1965-065P
    launchDate:
    1965-08-13
    satlat:
    56.675
    satlng:
    14.3041
    satalt:
    1117.8078
  7. satid:
    4911
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025FH
    launchDate:
    1970-04-08
    satlat:
    57.8684
    satlng:
    4.3114
    satalt:
    830.3595
  8. satid:
    5020
    satname:
    COSMOS 374 DEB
    intDesignator:
    1970-089W
    launchDate:
    1970-10-23
    satlat:
    61.1386
    satlng:
    15.7445
    satalt:
    1157.7083
  9. satid:
    5054
    satname:
    TITAN 34B AGENA D R/B
    intDesignator:
    1971-021B
    launchDate:
    1971-03-21
    satlat:
    61.676
    satlng:
    35.957
    satalt:
    35718.7923
  10. satid:
    5967
    satname:
    THORAD AGENA D DEB *
    intDesignator:
    1970-025MQ
    launchDate:
    1970-04-08
    satlat:
    60.0727
    satlng:
    10.4183
    satalt:
    1343.1414
  11. satid:
    6302
    satname:
    SL-6 R/B(2)
    intDesignator:
    1972-072E
    launchDate:
    1972-09-19
    satlat:
    68.2825
    satlng:
    29.5735
    satalt:
    31942.6544
  12. satid:
    7276
    satname:
    MOLNIYA 2-9
    intDesignator:
    1974-026A
    launchDate:
    1974-04-26
    satlat:
    58.6975
    satlng:
    30.2274
    satalt:
    31243.8186
  13. satid:
    7575
    satname:
    SL-3 R/B
    intDesignator:
    1974-099B
    launchDate:
    1974-12-17
    satlat:
    63.4218
    satlng:
    9.1298
    satalt:
    896.673
  14. satid:
    9896
    satname:
    COSMOS 862 DEB
    intDesignator:
    1976-105N
    launchDate:
    1976-10-22
    satlat:
    48.581
    satlng:
    -4.0468
    satalt:
    18744.1141
  15. satid:
    9956
    satname:
    COSMOS 886 DEB
    intDesignator:
    1976-126AW
    launchDate:
    1976-12-27
    satlat:
    63.7632
    satlng:
    -1.4383
    satalt:
    2262.8867
  16. satid:
    9979
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086GJ
    launchDate:
    1973-11-06
    satlat:
    54.9234
    satlng:
    5.557
    satalt:
    1452.4534
  17. satid:
    10091
    satname:
    NTS 2
    intDesignator:
    1977-053A
    launchDate:
    1977-06-23
    satlat:
    62.965
    satlng:
    -18.5891
    satalt:
    20329.5831
  18. satid:
    10438
    satname:
    COSMOS 839 DEB
    intDesignator:
    1976-067P
    launchDate:
    1976-07-08
    satlat:
    61.1524
    satlng:
    16.7467
    satalt:
    1677.6904
  19. satid:
    10562
    satname:
    COSMOS 970 DEB
    intDesignator:
    1977-121D
    launchDate:
    1977-12-21
    satlat:
    59.876
    satlng:
    13.7811
    satalt:
    1087.4704
  20. satid:
    11783
    satname:
    OPS 5118 (NAVSTAR 6)
    intDesignator:
    1980-032A
    launchDate:
    1980-04-26
    satlat:
    58.9383
    satlng:
    -20.253
    satalt:
    19000.0302
  21. satid:
    12815
    satname:
    COSMOS 931 DEB
    intDesignator:
    1977-068E
    launchDate:
    1977-07-20
    satlat:
    62.0224
    satlng:
    24.6907
    satalt:
    27817.8504
  22. satid:
    13133
    satname:
    TANSEI 3 DEB
    intDesignator:
    1977-012J
    launchDate:
    1977-02-19
    satlat:
    65.9041
    satlng:
    25.8744
    satalt:
    3119.7498
  23. satid:
    13169
    satname:
    SL-6 R/B(2)
    intDesignator:
    1982-029D
    launchDate:
    1982-04-07
    satlat:
    65.2592
    satlng:
    -15.0252
    satalt:
    20958.2593
  24. satid:
    14131
    satname:
    SL-6 DEB
    intDesignator:
    1981-088M
    launchDate:
    1981-09-11
    satlat:
    55.2404
    satlng:
    -6.9918
    satalt:
    6252.9902
  25. satid:
    14182
    satname:
    COSMOS 1481
    intDesignator:
    1983-070A
    launchDate:
    1983-07-08
    satlat:
    67.7234
    satlng:
    -15.8538
    satalt:
    19318.6114
limit:
25
offset:
0
returned:
25
has_more_results:
yes
next_offset:
25
Show all fields in HTML
info:
category:
ANY
transactionscount:
84
satcount:
127
above:

25 results

  1. satid:
    2367
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014S
    launchDate:
    1963-05-09
    satlat:
    54.1779
    satlng:
    11.0518
    satalt:
    3671.8389
  2. satid:
    2435
    satname:
    ESSA 3 (TOS-A)
    intDesignator:
    1966-087A
    launchDate:
    1966-10-02
    satlat:
    56.7322
    satlng:
    1.7654
    satalt:
    1402.1197
  3. satid:
    3555
    satname:
    COSMOS 252 DEB
    intDesignator:
    1968-097H
    launchDate:
    1968-11-01
    satlat:
    61.156
    satlng:
    10.3045
    satalt:
    1521.6613
  4. satid:
    3790
    satname:
    COSMOS 249 DEB *
    intDesignator:
    1968-091AX
    launchDate:
    1968-10-20
    satlat:
    56.9212
    satlng:
    18.2767
    satalt:
    1195.1063
  5. satid:
    3794
    satname:
    COSMOS 249 DEB
    intDesignator:
    1968-091BB
    launchDate:
    1968-10-20
    satlat:
    58.8106
    satlng:
    16.4419
    satalt:
    1531.7156
  6. satid:
    3810
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1965-065P
    launchDate:
    1965-08-13
    satlat:
    56.675
    satlng:
    14.3041
    satalt:
    1117.8078
  7. satid:
    4911
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025FH
    launchDate:
    1970-04-08
    satlat:
    57.8684
    satlng:
    4.3114
    satalt:
    830.3595
  8. satid:
    5020
    satname:
    COSMOS 374 DEB
    intDesignator:
    1970-089W
    launchDate:
    1970-10-23
    satlat:
    61.1386
    satlng:
    15.7445
    satalt:
    1157.7083
  9. satid:
    5054
    satname:
    TITAN 34B AGENA D R/B
    intDesignator:
    1971-021B
    launchDate:
    1971-03-21
    satlat:
    61.676
    satlng:
    35.957
    satalt:
    35718.7923
  10. satid:
    5967
    satname:
    THORAD AGENA D DEB *
    intDesignator:
    1970-025MQ
    launchDate:
    1970-04-08
    satlat:
    60.0727
    satlng:
    10.4183
    satalt:
    1343.1414
  11. satid:
    6302
    satname:
    SL-6 R/B(2)
    intDesignator:
    1972-072E
    launchDate:
    1972-09-19
    satlat:
    68.2825
    satlng:
    29.5735
    satalt:
    31942.6544
  12. satid:
    7276
    satname:
    MOLNIYA 2-9
    intDesignator:
    1974-026A
    launchDate:
    1974-04-26
    satlat:
    58.6975
    satlng:
    30.2274
    satalt:
    31243.8186
  13. satid:
    7575
    satname:
    SL-3 R/B
    intDesignator:
    1974-099B
    launchDate:
    1974-12-17
    satlat:
    63.4218
    satlng:
    9.1298
    satalt:
    896.673
  14. satid:
    9896
    satname:
    COSMOS 862 DEB
    intDesignator:
    1976-105N
    launchDate:
    1976-10-22
    satlat:
    48.581
    satlng:
    -4.0468
    satalt:
    18744.1141
  15. satid:
    9956
    satname:
    COSMOS 886 DEB
    intDesignator:
    1976-126AW
    launchDate:
    1976-12-27
    satlat:
    63.7632
    satlng:
    -1.4383
    satalt:
    2262.8867
  16. satid:
    9979
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086GJ
    launchDate:
    1973-11-06
    satlat:
    54.9234
    satlng:
    5.557
    satalt:
    1452.4534
  17. satid:
    10091
    satname:
    NTS 2
    intDesignator:
    1977-053A
    launchDate:
    1977-06-23
    satlat:
    62.965
    satlng:
    -18.5891
    satalt:
    20329.5831
  18. satid:
    10438
    satname:
    COSMOS 839 DEB
    intDesignator:
    1976-067P
    launchDate:
    1976-07-08
    satlat:
    61.1524
    satlng:
    16.7467
    satalt:
    1677.6904
  19. satid:
    10562
    satname:
    COSMOS 970 DEB
    intDesignator:
    1977-121D
    launchDate:
    1977-12-21
    satlat:
    59.876
    satlng:
    13.7811
    satalt:
    1087.4704
  20. satid:
    11783
    satname:
    OPS 5118 (NAVSTAR 6)
    intDesignator:
    1980-032A
    launchDate:
    1980-04-26
    satlat:
    58.9383
    satlng:
    -20.253
    satalt:
    19000.0302
  21. satid:
    12815
    satname:
    COSMOS 931 DEB
    intDesignator:
    1977-068E
    launchDate:
    1977-07-20
    satlat:
    62.0224
    satlng:
    24.6907
    satalt:
    27817.8504
  22. satid:
    13133
    satname:
    TANSEI 3 DEB
    intDesignator:
    1977-012J
    launchDate:
    1977-02-19
    satlat:
    65.9041
    satlng:
    25.8744
    satalt:
    3119.7498
  23. satid:
    13169
    satname:
    SL-6 R/B(2)
    intDesignator:
    1982-029D
    launchDate:
    1982-04-07
    satlat:
    65.2592
    satlng:
    -15.0252
    satalt:
    20958.2593
  24. satid:
    14131
    satname:
    SL-6 DEB
    intDesignator:
    1981-088M
    launchDate:
    1981-09-11
    satlat:
    55.2404
    satlng:
    -6.9918
    satalt:
    6252.9902
  25. satid:
    14182
    satname:
    COSMOS 1481
    intDesignator:
    1983-070A
    launchDate:
    1983-07-08
    satlat:
    67.7234
    satlng:
    -15.8538
    satalt:
    19318.6114
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.

AI agent? Read the complete navigation and programming guide.