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-16T18:18:14Z in 1.233 seconds.

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

25 results

  1. satid:
    3748
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1961-015JD
    launchDate:
    1961-06-29
    satlat:
    55.1282
    satlng:
    8.1215
    satalt:
    1623.2836
  2. satid:
    3758
    satname:
    COSMOS 249 DEB *
    intDesignator:
    1968-091AV
    launchDate:
    1968-10-20
    satlat:
    60.0848
    satlng:
    5.4652
    satalt:
    802.4264
  3. satid:
    3788
    satname:
    COSMOS 252 DEB
    intDesignator:
    1968-097BA
    launchDate:
    1968-11-01
    satlat:
    61.307
    satlng:
    0.9368
    satalt:
    1346.6257
  4. satid:
    4320
    satname:
    ITOS 1 (TIROS M)
    intDesignator:
    1970-008A
    launchDate:
    1970-01-23
    satlat:
    57.3843
    satlng:
    -0.1835
    satalt:
    1443.7246
  5. satid:
    4421
    satname:
    COSMOS 252 DEB *
    intDesignator:
    1968-097CF
    launchDate:
    1968-11-01
    satlat:
    62.8403
    satlng:
    5.2391
    satalt:
    1000.4604
  6. satid:
    4645
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025AD
    launchDate:
    1970-04-08
    satlat:
    62.6081
    satlng:
    7.0946
    satalt:
    1303.9812
  7. satid:
    5076
    satname:
    COSMOS 374 DEB
    intDesignator:
    1970-089AP
    launchDate:
    1970-10-23
    satlat:
    62.8209
    satlng:
    -5.1898
    satalt:
    1756.8772
  8. satid:
    7629
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-007D
    launchDate:
    1975-01-30
    satlat:
    68.3326
    satlng:
    31.2276
    satalt:
    30672.9366
  9. satid:
    10439
    satname:
    COSMOS 839 DEB
    intDesignator:
    1976-067Q
    launchDate:
    1976-07-08
    satlat:
    56.2022
    satlng:
    2.2949
    satalt:
    1315.3523
  10. satid:
    10893
    satname:
    OPS 5112 (NAVSTAR 2)
    intDesignator:
    1978-047A
    launchDate:
    1978-05-13
    satlat:
    49.3482
    satlng:
    5.5433
    satalt:
    18701.0324
  11. satid:
    11057
    satname:
    MOLNIYA 3-10
    intDesignator:
    1978-095A
    launchDate:
    1978-10-13
    satlat:
    56.6972
    satlng:
    38.8306
    satalt:
    17339.9031
  12. satid:
    12169
    satname:
    DELTA 1 DEB
    intDesignator:
    1978-026J
    launchDate:
    1978-03-05
    satlat:
    58.7845
    satlng:
    1.6863
    satalt:
    743.3516
  13. satid:
    12857
    satname:
    TANSEI 3 DEB
    intDesignator:
    1977-012H
    launchDate:
    1977-02-19
    satlat:
    55.2217
    satlng:
    4.5037
    satalt:
    984.8997
  14. satid:
    13163
    satname:
    COSMOS 1360
    intDesignator:
    1982-040D
    launchDate:
    1982-05-06
    satlat:
    56.696
    satlng:
    -1.7121
    satalt:
    1482.1592
  15. satid:
    13815
    satname:
    COSMOS 1275 DEB
    intDesignator:
    1981-053HN
    launchDate:
    1981-06-04
    satlat:
    59.5318
    satlng:
    11.1147
    satalt:
    898.0883
  16. satid:
    14172
    satname:
    COSMOS 1474
    intDesignator:
    1983-069B
    launchDate:
    1983-07-06
    satlat:
    57.9149
    satlng:
    -4.673
    satalt:
    1454.9391
  17. satid:
    14175
    satname:
    COSMOS 1477
    intDesignator:
    1983-069E
    launchDate:
    1983-07-06
    satlat:
    55.6881
    satlng:
    8.5784
    satalt:
    1473.0798
  18. satid:
    14191
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-070D
    launchDate:
    1983-07-08
    satlat:
    47.508
    satlng:
    -28.5896
    satalt:
    33525.8727
  19. satid:
    14894
    satname:
    SL-6 R/B(2)
    intDesignator:
    1984-033D
    launchDate:
    1984-04-04
    satlat:
    45.0709
    satlng:
    -2.3928
    satalt:
    33734.9452
  20. satid:
    15227
    satname:
    TITAN 34B R/B
    intDesignator:
    1984-091B
    launchDate:
    1984-08-28
    satlat:
    53.2007
    satlng:
    -26.2633
    satalt:
    28240.5902
  21. satid:
    15271
    satname:
    NAVSTAR 10 (USA 5)
    intDesignator:
    1984-097A
    launchDate:
    1984-09-08
    satlat:
    58.1382
    satlng:
    45.9813
    satalt:
    21278.6559
  22. satid:
    15621
    satname:
    COSMOS 1639
    intDesignator:
    1985-023E
    launchDate:
    1985-03-21
    satlat:
    63.6392
    satlng:
    11.0304
    satalt:
    1486.3908
  23. satid:
    15741
    satname:
    SL-6 R/B(2)
    intDesignator:
    1985-040D
    launchDate:
    1985-05-29
    satlat:
    58.5609
    satlng:
    29.9699
    satalt:
    39906.9923
  24. satid:
    16393
    satname:
    MOLNIYA 3-27
    intDesignator:
    1985-117A
    launchDate:
    1985-12-24
    satlat:
    55.2484
    satlng:
    -43.2399
    satalt:
    36974.2141
  25. satid:
    17328
    satname:
    MOLNIYA 3-31
    intDesignator:
    1987-008A
    launchDate:
    1987-01-22
    satlat:
    61.4936
    satlng:
    54.543
    satalt:
    36582.1699
limit:
25
offset:
0
returned:
25
has_more_results:
yes
next_offset:
25
Show all fields in HTML
info:
category:
ANY
transactionscount:
94
satcount:
113
above:

25 results

  1. satid:
    3748
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1961-015JD
    launchDate:
    1961-06-29
    satlat:
    55.1282
    satlng:
    8.1215
    satalt:
    1623.2836
  2. satid:
    3758
    satname:
    COSMOS 249 DEB *
    intDesignator:
    1968-091AV
    launchDate:
    1968-10-20
    satlat:
    60.0848
    satlng:
    5.4652
    satalt:
    802.4264
  3. satid:
    3788
    satname:
    COSMOS 252 DEB
    intDesignator:
    1968-097BA
    launchDate:
    1968-11-01
    satlat:
    61.307
    satlng:
    0.9368
    satalt:
    1346.6257
  4. satid:
    4320
    satname:
    ITOS 1 (TIROS M)
    intDesignator:
    1970-008A
    launchDate:
    1970-01-23
    satlat:
    57.3843
    satlng:
    -0.1835
    satalt:
    1443.7246
  5. satid:
    4421
    satname:
    COSMOS 252 DEB *
    intDesignator:
    1968-097CF
    launchDate:
    1968-11-01
    satlat:
    62.8403
    satlng:
    5.2391
    satalt:
    1000.4604
  6. satid:
    4645
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025AD
    launchDate:
    1970-04-08
    satlat:
    62.6081
    satlng:
    7.0946
    satalt:
    1303.9812
  7. satid:
    5076
    satname:
    COSMOS 374 DEB
    intDesignator:
    1970-089AP
    launchDate:
    1970-10-23
    satlat:
    62.8209
    satlng:
    -5.1898
    satalt:
    1756.8772
  8. satid:
    7629
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-007D
    launchDate:
    1975-01-30
    satlat:
    68.3326
    satlng:
    31.2276
    satalt:
    30672.9366
  9. satid:
    10439
    satname:
    COSMOS 839 DEB
    intDesignator:
    1976-067Q
    launchDate:
    1976-07-08
    satlat:
    56.2022
    satlng:
    2.2949
    satalt:
    1315.3523
  10. satid:
    10893
    satname:
    OPS 5112 (NAVSTAR 2)
    intDesignator:
    1978-047A
    launchDate:
    1978-05-13
    satlat:
    49.3482
    satlng:
    5.5433
    satalt:
    18701.0324
  11. satid:
    11057
    satname:
    MOLNIYA 3-10
    intDesignator:
    1978-095A
    launchDate:
    1978-10-13
    satlat:
    56.6972
    satlng:
    38.8306
    satalt:
    17339.9031
  12. satid:
    12169
    satname:
    DELTA 1 DEB
    intDesignator:
    1978-026J
    launchDate:
    1978-03-05
    satlat:
    58.7845
    satlng:
    1.6863
    satalt:
    743.3516
  13. satid:
    12857
    satname:
    TANSEI 3 DEB
    intDesignator:
    1977-012H
    launchDate:
    1977-02-19
    satlat:
    55.2217
    satlng:
    4.5037
    satalt:
    984.8997
  14. satid:
    13163
    satname:
    COSMOS 1360
    intDesignator:
    1982-040D
    launchDate:
    1982-05-06
    satlat:
    56.696
    satlng:
    -1.7121
    satalt:
    1482.1592
  15. satid:
    13815
    satname:
    COSMOS 1275 DEB
    intDesignator:
    1981-053HN
    launchDate:
    1981-06-04
    satlat:
    59.5318
    satlng:
    11.1147
    satalt:
    898.0883
  16. satid:
    14172
    satname:
    COSMOS 1474
    intDesignator:
    1983-069B
    launchDate:
    1983-07-06
    satlat:
    57.9149
    satlng:
    -4.673
    satalt:
    1454.9391
  17. satid:
    14175
    satname:
    COSMOS 1477
    intDesignator:
    1983-069E
    launchDate:
    1983-07-06
    satlat:
    55.6881
    satlng:
    8.5784
    satalt:
    1473.0798
  18. satid:
    14191
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-070D
    launchDate:
    1983-07-08
    satlat:
    47.508
    satlng:
    -28.5896
    satalt:
    33525.8727
  19. satid:
    14894
    satname:
    SL-6 R/B(2)
    intDesignator:
    1984-033D
    launchDate:
    1984-04-04
    satlat:
    45.0709
    satlng:
    -2.3928
    satalt:
    33734.9452
  20. satid:
    15227
    satname:
    TITAN 34B R/B
    intDesignator:
    1984-091B
    launchDate:
    1984-08-28
    satlat:
    53.2007
    satlng:
    -26.2633
    satalt:
    28240.5902
  21. satid:
    15271
    satname:
    NAVSTAR 10 (USA 5)
    intDesignator:
    1984-097A
    launchDate:
    1984-09-08
    satlat:
    58.1382
    satlng:
    45.9813
    satalt:
    21278.6559
  22. satid:
    15621
    satname:
    COSMOS 1639
    intDesignator:
    1985-023E
    launchDate:
    1985-03-21
    satlat:
    63.6392
    satlng:
    11.0304
    satalt:
    1486.3908
  23. satid:
    15741
    satname:
    SL-6 R/B(2)
    intDesignator:
    1985-040D
    launchDate:
    1985-05-29
    satlat:
    58.5609
    satlng:
    29.9699
    satalt:
    39906.9923
  24. satid:
    16393
    satname:
    MOLNIYA 3-27
    intDesignator:
    1985-117A
    launchDate:
    1985-12-24
    satlat:
    55.2484
    satlng:
    -43.2399
    satalt:
    36974.2141
  25. satid:
    17328
    satname:
    MOLNIYA 3-31
    intDesignator:
    1987-008A
    launchDate:
    1987-01-22
    satlat:
    61.4936
    satlng:
    54.543
    satalt:
    36582.1699
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.