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-15T17:16:18Z in 1.462 seconds.

info:
category:
ANY
transactionscount:
92
satcount:
99
above:

25 results

  1. satid:
    3592
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1965-048F
    launchDate:
    1965-06-24
    satlat:
    57.8871
    satlng:
    3.0286
    satalt:
    1035.6153
  2. satid:
    4635
    satname:
    COSMOS 375 DEB
    intDesignator:
    1970-091M
    launchDate:
    1970-10-30
    satlat:
    62.324
    satlng:
    9.7047
    satalt:
    1716.7535
  3. satid:
    7629
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-007D
    launchDate:
    1975-01-30
    satlat:
    66.1023
    satlng:
    2.9894
    satalt:
    25726.4449
  4. satid:
    9271
    satname:
    TITAN 34B AGENA R/B
    intDesignator:
    1976-080B
    launchDate:
    1976-08-06
    satlat:
    63.9649
    satlng:
    47.0448
    satalt:
    27826.9493
  5. satid:
    9823
    satname:
    COSMOS 886 DEB
    intDesignator:
    1976-126AK
    launchDate:
    1976-12-27
    satlat:
    59.7293
    satlng:
    7.994
    satalt:
    1370.7383
  6. satid:
    10155
    satname:
    SL-6 R/B(2)
    intDesignator:
    1977-054D
    launchDate:
    1977-06-24
    satlat:
    61.1827
    satlng:
    23.6192
    satalt:
    30964.1955
  7. satid:
    10541
    satname:
    SL-14 R/B
    intDesignator:
    1977-123B
    launchDate:
    1977-12-27
    satlat:
    54.2172
    satlng:
    11.515
    satalt:
    1098.1448
  8. satid:
    11045
    satname:
    COSMOS 1036
    intDesignator:
    1978-091C
    launchDate:
    1978-10-04
    satlat:
    58.0126
    satlng:
    11.036
    satalt:
    1486.5193
  9. satid:
    11079
    satname:
    SL-6 R/B(2)
    intDesignator:
    1978-095E
    launchDate:
    1978-10-13
    satlat:
    60.4074
    satlng:
    32.7229
    satalt:
    31467.2705
  10. satid:
    11114
    satname:
    SL-8 DEB
    intDesignator:
    1978-105D
    launchDate:
    1978-11-16
    satlat:
    58.0731
    satlng:
    3.5722
    satalt:
    511.4394
  11. satid:
    12112
    satname:
    COSMOS 1233
    intDesignator:
    1980-102F
    launchDate:
    1980-12-23
    satlat:
    59.4239
    satlng:
    -2.2959
    satalt:
    1463.868
  12. satid:
    12321
    satname:
    COSMOS 1251
    intDesignator:
    1981-022B
    launchDate:
    1981-03-06
    satlat:
    58.6337
    satlng:
    7.1893
    satalt:
    1450.4434
  13. satid:
    12329
    satname:
    KYOKKO 1 DEB
    intDesignator:
    1978-014C
    launchDate:
    1978-02-04
    satlat:
    60.9427
    satlng:
    2.7493
    satalt:
    2446.3671
  14. satid:
    13124
    satname:
    COSMOS 1348
    intDesignator:
    1982-029A
    launchDate:
    1982-04-07
    satlat:
    37.6509
    satlng:
    23.1973
    satalt:
    32489.3779
  15. satid:
    15741
    satname:
    SL-6 R/B(2)
    intDesignator:
    1985-040D
    launchDate:
    1985-05-29
    satlat:
    56.3563
    satlng:
    39.1957
    satalt:
    38642.9548
  16. satid:
    16445
    satname:
    SL-12 R/B(AUX MOTOR)
    intDesignator:
    1985-118K
    launchDate:
    1985-12-24
    satlat:
    46.8731
    satlng:
    7.032
    satalt:
    10472.6196
  17. satid:
    17328
    satname:
    MOLNIYA 3-31
    intDesignator:
    1987-008A
    launchDate:
    1987-01-22
    satlat:
    61.7503
    satlng:
    54.1048
    satalt:
    39123.9227
  18. satid:
    20452
    satname:
    NAVSTAR 18 (USA 50)
    intDesignator:
    1990-008A
    launchDate:
    1990-01-24
    satlat:
    39.5068
    satlng:
    -9.2988
    satalt:
    21232.4365
  19. satid:
    20503
    satname:
    COSMOS 839 DEB *
    intDesignator:
    1976-067BX
    launchDate:
    1976-07-08
    satlat:
    60.8681
    satlng:
    8.2289
    satalt:
    1935.5641
  20. satid:
    20533
    satname:
    NAVSTAR 19 (USA 54)
    intDesignator:
    1990-025A
    launchDate:
    1990-03-26
    satlat:
    39.3262
    satlng:
    -4.9172
    satalt:
    21189.5792
  21. satid:
    21115
    satname:
    SL-8 DEB
    intDesignator:
    1991-009M
    launchDate:
    1991-02-12
    satlat:
    59.6476
    satlng:
    13.8475
    satalt:
    1672.6209
  22. satid:
    21429
    satname:
    SL-6 R/B(2)
    intDesignator:
    1991-043D
    launchDate:
    1991-06-18
    satlat:
    41.5726
    satlng:
    -21.5099
    satalt:
    26920.6965
  23. satid:
    21470
    satname:
    DELTA 1 DEB
    intDesignator:
    1975-052FE
    launchDate:
    1975-06-12
    satlat:
    55.4136
    satlng:
    4.0894
    satalt:
    1147.704
  24. satid:
    21725
    satname:
    SL-12 DEB
    intDesignator:
    1987-036N
    launchDate:
    1987-04-24
    satlat:
    61.3828
    satlng:
    5.6655
    satalt:
    1464.5835
  25. satid:
    21775
    satname:
    USA 72
    intDesignator:
    1991-076A
    launchDate:
    1991-11-08
    satlat:
    62.322
    satlng:
    -15.1238
    satalt:
    11599.9424
limit:
25
offset:
0
returned:
25
has_more_results:
yes
next_offset:
25
Show all fields in HTML
info:
category:
ANY
transactionscount:
92
satcount:
99
above:

25 results

  1. satid:
    3592
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1965-048F
    launchDate:
    1965-06-24
    satlat:
    57.8871
    satlng:
    3.0286
    satalt:
    1035.6153
  2. satid:
    4635
    satname:
    COSMOS 375 DEB
    intDesignator:
    1970-091M
    launchDate:
    1970-10-30
    satlat:
    62.324
    satlng:
    9.7047
    satalt:
    1716.7535
  3. satid:
    7629
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-007D
    launchDate:
    1975-01-30
    satlat:
    66.1023
    satlng:
    2.9894
    satalt:
    25726.4449
  4. satid:
    9271
    satname:
    TITAN 34B AGENA R/B
    intDesignator:
    1976-080B
    launchDate:
    1976-08-06
    satlat:
    63.9649
    satlng:
    47.0448
    satalt:
    27826.9493
  5. satid:
    9823
    satname:
    COSMOS 886 DEB
    intDesignator:
    1976-126AK
    launchDate:
    1976-12-27
    satlat:
    59.7293
    satlng:
    7.994
    satalt:
    1370.7383
  6. satid:
    10155
    satname:
    SL-6 R/B(2)
    intDesignator:
    1977-054D
    launchDate:
    1977-06-24
    satlat:
    61.1827
    satlng:
    23.6192
    satalt:
    30964.1955
  7. satid:
    10541
    satname:
    SL-14 R/B
    intDesignator:
    1977-123B
    launchDate:
    1977-12-27
    satlat:
    54.2172
    satlng:
    11.515
    satalt:
    1098.1448
  8. satid:
    11045
    satname:
    COSMOS 1036
    intDesignator:
    1978-091C
    launchDate:
    1978-10-04
    satlat:
    58.0126
    satlng:
    11.036
    satalt:
    1486.5193
  9. satid:
    11079
    satname:
    SL-6 R/B(2)
    intDesignator:
    1978-095E
    launchDate:
    1978-10-13
    satlat:
    60.4074
    satlng:
    32.7229
    satalt:
    31467.2705
  10. satid:
    11114
    satname:
    SL-8 DEB
    intDesignator:
    1978-105D
    launchDate:
    1978-11-16
    satlat:
    58.0731
    satlng:
    3.5722
    satalt:
    511.4394
  11. satid:
    12112
    satname:
    COSMOS 1233
    intDesignator:
    1980-102F
    launchDate:
    1980-12-23
    satlat:
    59.4239
    satlng:
    -2.2959
    satalt:
    1463.868
  12. satid:
    12321
    satname:
    COSMOS 1251
    intDesignator:
    1981-022B
    launchDate:
    1981-03-06
    satlat:
    58.6337
    satlng:
    7.1893
    satalt:
    1450.4434
  13. satid:
    12329
    satname:
    KYOKKO 1 DEB
    intDesignator:
    1978-014C
    launchDate:
    1978-02-04
    satlat:
    60.9427
    satlng:
    2.7493
    satalt:
    2446.3671
  14. satid:
    13124
    satname:
    COSMOS 1348
    intDesignator:
    1982-029A
    launchDate:
    1982-04-07
    satlat:
    37.6509
    satlng:
    23.1973
    satalt:
    32489.3779
  15. satid:
    15741
    satname:
    SL-6 R/B(2)
    intDesignator:
    1985-040D
    launchDate:
    1985-05-29
    satlat:
    56.3563
    satlng:
    39.1957
    satalt:
    38642.9548
  16. satid:
    16445
    satname:
    SL-12 R/B(AUX MOTOR)
    intDesignator:
    1985-118K
    launchDate:
    1985-12-24
    satlat:
    46.8731
    satlng:
    7.032
    satalt:
    10472.6196
  17. satid:
    17328
    satname:
    MOLNIYA 3-31
    intDesignator:
    1987-008A
    launchDate:
    1987-01-22
    satlat:
    61.7503
    satlng:
    54.1048
    satalt:
    39123.9227
  18. satid:
    20452
    satname:
    NAVSTAR 18 (USA 50)
    intDesignator:
    1990-008A
    launchDate:
    1990-01-24
    satlat:
    39.5068
    satlng:
    -9.2988
    satalt:
    21232.4365
  19. satid:
    20503
    satname:
    COSMOS 839 DEB *
    intDesignator:
    1976-067BX
    launchDate:
    1976-07-08
    satlat:
    60.8681
    satlng:
    8.2289
    satalt:
    1935.5641
  20. satid:
    20533
    satname:
    NAVSTAR 19 (USA 54)
    intDesignator:
    1990-025A
    launchDate:
    1990-03-26
    satlat:
    39.3262
    satlng:
    -4.9172
    satalt:
    21189.5792
  21. satid:
    21115
    satname:
    SL-8 DEB
    intDesignator:
    1991-009M
    launchDate:
    1991-02-12
    satlat:
    59.6476
    satlng:
    13.8475
    satalt:
    1672.6209
  22. satid:
    21429
    satname:
    SL-6 R/B(2)
    intDesignator:
    1991-043D
    launchDate:
    1991-06-18
    satlat:
    41.5726
    satlng:
    -21.5099
    satalt:
    26920.6965
  23. satid:
    21470
    satname:
    DELTA 1 DEB
    intDesignator:
    1975-052FE
    launchDate:
    1975-06-12
    satlat:
    55.4136
    satlng:
    4.0894
    satalt:
    1147.704
  24. satid:
    21725
    satname:
    SL-12 DEB
    intDesignator:
    1987-036N
    launchDate:
    1987-04-24
    satlat:
    61.3828
    satlng:
    5.6655
    satalt:
    1464.5835
  25. satid:
    21775
    satname:
    USA 72
    intDesignator:
    1991-076A
    launchDate:
    1991-11-08
    satlat:
    62.322
    satlng:
    -15.1238
    satalt:
    11599.9424
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.