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-22T19:16:08Z in 1.117 seconds.

info:
category:
ANY
transactionscount:
76
satcount:
116
above:

25 results

  1. satid:
    1099
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1964-083G
    launchDate:
    1964-12-13
    satlat:
    70.486
    satlng:
    24.8385
    satalt:
    1047.9796
  2. satid:
    2092
    satname:
    THOR AGENA B DEB
    intDesignator:
    1965-098H
    launchDate:
    1965-11-29
    satlat:
    71.2434
    satlng:
    18.2812
    satalt:
    2534.549
  3. satid:
    2531
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014AK
    launchDate:
    1963-05-09
    satlat:
    79.3854
    satlng:
    26.6714
    satalt:
    3657.4377
  4. satid:
    2933
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014AR
    launchDate:
    1963-05-09
    satlat:
    65.4108
    satlng:
    36.9374
    satalt:
    3536.5149
  5. satid:
    4589
    satname:
    SL-8 R/B
    intDesignator:
    1970-086B
    launchDate:
    1970-10-16
    satlat:
    67.6901
    satlng:
    18.1558
    satalt:
    771.6243
  6. satid:
    5550
    satname:
    COSMOS 447
    intDesignator:
    1971-086D
    launchDate:
    1971-10-13
    satlat:
    66.6027
    satlng:
    27.2921
    satalt:
    1454.7058
  7. satid:
    6302
    satname:
    SL-6 R/B(2)
    intDesignator:
    1972-072E
    launchDate:
    1972-09-19
    satlat:
    50.3801
    satlng:
    35.326
    satalt:
    29642.3268
  8. satid:
    6659
    satname:
    METEOR 1-15
    intDesignator:
    1973-034A
    launchDate:
    1973-05-29
    satlat:
    67.1797
    satlng:
    18.2109
    satalt:
    849.3065
  9. satid:
    7373
    satname:
    SL-6 R/B(2)
    intDesignator:
    1974-026E
    launchDate:
    1974-04-26
    satlat:
    48.5807
    satlng:
    24.029
    satalt:
    26379.6802
  10. satid:
    7376
    satname:
    MOLNIYA 2-10
    intDesignator:
    1974-056A
    launchDate:
    1974-07-23
    satlat:
    61.7342
    satlng:
    59.1056
    satalt:
    35994.6718
  11. satid:
    7629
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-007D
    launchDate:
    1975-01-30
    satlat:
    62.8022
    satlng:
    -14.8884
    satalt:
    23720.9693
  12. satid:
    9896
    satname:
    COSMOS 862 DEB
    intDesignator:
    1976-105N
    launchDate:
    1976-10-22
    satlat:
    63.4915
    satlng:
    -17.0242
    satalt:
    35064.1779
  13. satid:
    10155
    satname:
    SL-6 R/B(2)
    intDesignator:
    1977-054D
    launchDate:
    1977-06-24
    satlat:
    63.0402
    satlng:
    9.2883
    satalt:
    31539.6098
  14. satid:
    10287
    satname:
    COSMOS 941
    intDesignator:
    1977-079C
    launchDate:
    1977-08-24
    satlat:
    68.6188
    satlng:
    17.2055
    satalt:
    1462.9448
  15. satid:
    10615
    satname:
    COSMOS 839 DEB
    intDesignator:
    1976-067AP
    launchDate:
    1976-07-08
    satlat:
    66.0794
    satlng:
    9.1372
    satalt:
    1835.4458
  16. satid:
    11131
    satname:
    COSMOS 1054
    intDesignator:
    1978-109D
    launchDate:
    1978-12-05
    satlat:
    73.6034
    satlng:
    26.0424
    satalt:
    1496.5614
  17. satid:
    12674
    satname:
    COSMOS 1275 DEB
    intDesignator:
    1981-053AE
    launchDate:
    1981-06-04
    satlat:
    68.6568
    satlng:
    21.6113
    satalt:
    918.1122
  18. satid:
    12980
    satname:
    COSMOS 1325
    intDesignator:
    1981-116F
    launchDate:
    1981-11-28
    satlat:
    72.7307
    satlng:
    35.5918
    satalt:
    1520.4371
  19. satid:
    12987
    satname:
    COSMOS 1328
    intDesignator:
    1981-117A
    launchDate:
    1981-12-03
    satlat:
    68.2983
    satlng:
    19.6361
    satalt:
    464.3322
  20. satid:
    13301
    satname:
    COSMOS 1383
    intDesignator:
    1982-066A
    launchDate:
    1982-06-29
    satlat:
    67.881
    satlng:
    29.2807
    satalt:
    1010.905
  21. satid:
    13882
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-015E
    launchDate:
    1983-03-11
    satlat:
    53.6583
    satlng:
    51.1174
    satalt:
    31687.5898
  22. satid:
    13890
    satname:
    MOLNIYA 1-56
    intDesignator:
    1983-019A
    launchDate:
    1983-03-16
    satlat:
    62.5957
    satlng:
    -43.0472
    satalt:
    38469.8761
  23. satid:
    13897
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-019D
    launchDate:
    1983-03-16
    satlat:
    58.7718
    satlng:
    21.9726
    satalt:
    38146.8295
  24. satid:
    14191
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-070D
    launchDate:
    1983-07-08
    satlat:
    70.4179
    satlng:
    40.7175
    satalt:
    30733.2435
  25. satid:
    14192
    satname:
    COSMOS 1481 DEB
    intDesignator:
    1983-070E
    launchDate:
    1983-07-08
    satlat:
    69.3706
    satlng:
    11.0475
    satalt:
    28098.5741
limit:
25
offset:
0
returned:
25
has_more_results:
yes
truncated:
yes
next_offset:
25
Show all fields in HTML
info:
category:
ANY
transactionscount:
76
satcount:
116
above:

25 results

  1. satid:
    1099
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1964-083G
    launchDate:
    1964-12-13
    satlat:
    70.486
    satlng:
    24.8385
    satalt:
    1047.9796
  2. satid:
    2092
    satname:
    THOR AGENA B DEB
    intDesignator:
    1965-098H
    launchDate:
    1965-11-29
    satlat:
    71.2434
    satlng:
    18.2812
    satalt:
    2534.549
  3. satid:
    2531
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014AK
    launchDate:
    1963-05-09
    satlat:
    79.3854
    satlng:
    26.6714
    satalt:
    3657.4377
  4. satid:
    2933
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014AR
    launchDate:
    1963-05-09
    satlat:
    65.4108
    satlng:
    36.9374
    satalt:
    3536.5149
  5. satid:
    4589
    satname:
    SL-8 R/B
    intDesignator:
    1970-086B
    launchDate:
    1970-10-16
    satlat:
    67.6901
    satlng:
    18.1558
    satalt:
    771.6243
  6. satid:
    5550
    satname:
    COSMOS 447
    intDesignator:
    1971-086D
    launchDate:
    1971-10-13
    satlat:
    66.6027
    satlng:
    27.2921
    satalt:
    1454.7058
  7. satid:
    6302
    satname:
    SL-6 R/B(2)
    intDesignator:
    1972-072E
    launchDate:
    1972-09-19
    satlat:
    50.3801
    satlng:
    35.326
    satalt:
    29642.3268
  8. satid:
    6659
    satname:
    METEOR 1-15
    intDesignator:
    1973-034A
    launchDate:
    1973-05-29
    satlat:
    67.1797
    satlng:
    18.2109
    satalt:
    849.3065
  9. satid:
    7373
    satname:
    SL-6 R/B(2)
    intDesignator:
    1974-026E
    launchDate:
    1974-04-26
    satlat:
    48.5807
    satlng:
    24.029
    satalt:
    26379.6802
  10. satid:
    7376
    satname:
    MOLNIYA 2-10
    intDesignator:
    1974-056A
    launchDate:
    1974-07-23
    satlat:
    61.7342
    satlng:
    59.1056
    satalt:
    35994.6718
  11. satid:
    7629
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-007D
    launchDate:
    1975-01-30
    satlat:
    62.8022
    satlng:
    -14.8884
    satalt:
    23720.9693
  12. satid:
    9896
    satname:
    COSMOS 862 DEB
    intDesignator:
    1976-105N
    launchDate:
    1976-10-22
    satlat:
    63.4915
    satlng:
    -17.0242
    satalt:
    35064.1779
  13. satid:
    10155
    satname:
    SL-6 R/B(2)
    intDesignator:
    1977-054D
    launchDate:
    1977-06-24
    satlat:
    63.0402
    satlng:
    9.2883
    satalt:
    31539.6098
  14. satid:
    10287
    satname:
    COSMOS 941
    intDesignator:
    1977-079C
    launchDate:
    1977-08-24
    satlat:
    68.6188
    satlng:
    17.2055
    satalt:
    1462.9448
  15. satid:
    10615
    satname:
    COSMOS 839 DEB
    intDesignator:
    1976-067AP
    launchDate:
    1976-07-08
    satlat:
    66.0794
    satlng:
    9.1372
    satalt:
    1835.4458
  16. satid:
    11131
    satname:
    COSMOS 1054
    intDesignator:
    1978-109D
    launchDate:
    1978-12-05
    satlat:
    73.6034
    satlng:
    26.0424
    satalt:
    1496.5614
  17. satid:
    12674
    satname:
    COSMOS 1275 DEB
    intDesignator:
    1981-053AE
    launchDate:
    1981-06-04
    satlat:
    68.6568
    satlng:
    21.6113
    satalt:
    918.1122
  18. satid:
    12980
    satname:
    COSMOS 1325
    intDesignator:
    1981-116F
    launchDate:
    1981-11-28
    satlat:
    72.7307
    satlng:
    35.5918
    satalt:
    1520.4371
  19. satid:
    12987
    satname:
    COSMOS 1328
    intDesignator:
    1981-117A
    launchDate:
    1981-12-03
    satlat:
    68.2983
    satlng:
    19.6361
    satalt:
    464.3322
  20. satid:
    13301
    satname:
    COSMOS 1383
    intDesignator:
    1982-066A
    launchDate:
    1982-06-29
    satlat:
    67.881
    satlng:
    29.2807
    satalt:
    1010.905
  21. satid:
    13882
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-015E
    launchDate:
    1983-03-11
    satlat:
    53.6583
    satlng:
    51.1174
    satalt:
    31687.5898
  22. satid:
    13890
    satname:
    MOLNIYA 1-56
    intDesignator:
    1983-019A
    launchDate:
    1983-03-16
    satlat:
    62.5957
    satlng:
    -43.0472
    satalt:
    38469.8761
  23. satid:
    13897
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-019D
    launchDate:
    1983-03-16
    satlat:
    58.7718
    satlng:
    21.9726
    satalt:
    38146.8295
  24. satid:
    14191
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-070D
    launchDate:
    1983-07-08
    satlat:
    70.4179
    satlng:
    40.7175
    satalt:
    30733.2435
  25. satid:
    14192
    satname:
    COSMOS 1481 DEB
    intDesignator:
    1983-070E
    launchDate:
    1983-07-08
    satlat:
    69.3706
    satlng:
    11.0475
    satalt:
    28098.5741
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.