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-11-19T23:21:11Z in 1.307 seconds.

info:
category:
ANY
transactionscount:
87
satcount:
124
above:

25 results

  1. satid:
    4138
    satname:
    COSMOS 304
    intDesignator:
    1969-091A
    launchDate:
    1969-10-21
    satlat:
    70.6649
    satlng:
    17.1597
    satalt:
    758.6565
  2. satid:
    4432
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1969-082ED
    launchDate:
    1969-09-30
    satlat:
    66.915
    satlng:
    18.1834
    satalt:
    840.667
  3. satid:
    4657
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025AR
    launchDate:
    1970-04-08
    satlat:
    71.4058
    satlng:
    12.8616
    satalt:
    1002.6259
  4. satid:
    5551
    satname:
    COSMOS 448
    intDesignator:
    1971-086E
    launchDate:
    1971-10-13
    satlat:
    67.3192
    satlng:
    22.4912
    satalt:
    1522.469
  5. satid:
    7015
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086F
    launchDate:
    1973-11-06
    satlat:
    64.286
    satlng:
    14.7806
    satalt:
    1631.0202
  6. satid:
    8195
    satname:
    MOLNIYA 2-14
    intDesignator:
    1975-081A
    launchDate:
    1975-09-09
    satlat:
    63.1811
    satlng:
    34.2174
    satalt:
    32383.0686
  7. satid:
    8290
    satname:
    COSMOS 766
    intDesignator:
    1975-086F
    launchDate:
    1975-09-17
    satlat:
    68.9977
    satlng:
    17.1824
    satalt:
    1482.3362
  8. satid:
    9591
    satname:
    COSMOS 874
    intDesignator:
    1976-118D
    launchDate:
    1976-12-07
    satlat:
    68.9346
    satlng:
    30.6807
    satalt:
    1499.4537
  9. satid:
    9799
    satname:
    COSMOS 886 DEB *
    intDesignator:
    1976-126Z
    launchDate:
    1976-12-27
    satlat:
    62.8166
    satlng:
    9.2962
    satalt:
    2015.2505
  10. satid:
    9890
    satname:
    COSMOS 862 DEB
    intDesignator:
    1976-105G
    launchDate:
    1976-10-22
    satlat:
    61.7989
    satlng:
    6.1316
    satalt:
    22097.6828
  11. satid:
    10588
    satname:
    COSMOS 981
    intDesignator:
    1978-005F
    launchDate:
    1978-01-10
    satlat:
    67.8997
    satlng:
    6.3966
    satalt:
    1506.1846
  12. satid:
    10714
    satname:
    DELTA 1 DEB
    intDesignator:
    1976-077AK
    launchDate:
    1976-07-29
    satlat:
    71.2022
    satlng:
    26.7864
    satalt:
    1431.7257
  13. satid:
    10936
    satname:
    COSMOS 1019
    intDesignator:
    1978-056G
    launchDate:
    1978-06-07
    satlat:
    67.7661
    satlng:
    17.8479
    satalt:
    1435.5586
  14. satid:
    11690
    satname:
    OPS 5117 (NAVSTAR 5)
    intDesignator:
    1980-011A
    launchDate:
    1980-02-09
    satlat:
    44.9714
    satlng:
    22.4324
    satalt:
    21352.4663
  15. satid:
    11696
    satname:
    COSMOS 1161
    intDesignator:
    1980-012F
    launchDate:
    1980-02-11
    satlat:
    73.4652
    satlng:
    14.8638
    satalt:
    1499.7008
  16. satid:
    11847
    satname:
    SL-6 R/B(2)
    intDesignator:
    1980-050B
    launchDate:
    1980-06-14
    satlat:
    67.0383
    satlng:
    56.9017
    satalt:
    29701.8211
  17. satid:
    12322
    satname:
    COSMOS 1252
    intDesignator:
    1981-022C
    launchDate:
    1981-03-06
    satlat:
    68.0116
    satlng:
    11.3503
    satalt:
    1467.3432
  18. satid:
    12330
    satname:
    KYOKKO 1 DEB
    intDesignator:
    1978-014D
    launchDate:
    1978-02-04
    satlat:
    65.0465
    satlng:
    20.9986
    satalt:
    2696.5409
  19. satid:
    12984
    satname:
    COSMOS 1247 DEB
    intDesignator:
    1981-016F
    launchDate:
    1981-02-19
    satlat:
    67.1696
    satlng:
    66.5955
    satalt:
    19901.2454
  20. satid:
    13012
    satname:
    MOLNIYA 1-52
    intDesignator:
    1981-123A
    launchDate:
    1981-12-23
    satlat:
    61.4714
    satlng:
    70.1664
    satalt:
    35621.9978
  21. satid:
    13480
    satname:
    COSMOS 1275 DEB
    intDesignator:
    1981-053GC
    launchDate:
    1981-06-04
    satlat:
    65.3164
    satlng:
    13.3499
    satalt:
    931.6267
  22. satid:
    13909
    satname:
    SL-6 DEB
    intDesignator:
    1981-088J
    launchDate:
    1981-09-11
    satlat:
    61.1531
    satlng:
    37.2716
    satalt:
    11520.9636
  23. satid:
    14096
    satname:
    DELTA 1 R/B
    intDesignator:
    1983-051B
    launchDate:
    1983-05-26
    satlat:
    66.3644
    satlng:
    23.6815
    satalt:
    1558.916
  24. satid:
    14259
    satname:
    COSMOS 1491 (GLONASS)
    intDesignator:
    1983-084B
    launchDate:
    1983-08-10
    satlat:
    63.6516
    satlng:
    72.3469
    satalt:
    18994.4931
  25. satid:
    14734
    satname:
    COSMOS 1317 DEB
    intDesignator:
    1981-108E
    launchDate:
    1981-10-31
    satlat:
    69.1875
    satlng:
    65.3818
    satalt:
    22606.5273
Show all fields in HTML
info:
category:
ANY
transactionscount:
87
satcount:
124
above:

25 results

  1. satid:
    4138
    satname:
    COSMOS 304
    intDesignator:
    1969-091A
    launchDate:
    1969-10-21
    satlat:
    70.6649
    satlng:
    17.1597
    satalt:
    758.6565
  2. satid:
    4432
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1969-082ED
    launchDate:
    1969-09-30
    satlat:
    66.915
    satlng:
    18.1834
    satalt:
    840.667
  3. satid:
    4657
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025AR
    launchDate:
    1970-04-08
    satlat:
    71.4058
    satlng:
    12.8616
    satalt:
    1002.6259
  4. satid:
    5551
    satname:
    COSMOS 448
    intDesignator:
    1971-086E
    launchDate:
    1971-10-13
    satlat:
    67.3192
    satlng:
    22.4912
    satalt:
    1522.469
  5. satid:
    7015
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086F
    launchDate:
    1973-11-06
    satlat:
    64.286
    satlng:
    14.7806
    satalt:
    1631.0202
  6. satid:
    8195
    satname:
    MOLNIYA 2-14
    intDesignator:
    1975-081A
    launchDate:
    1975-09-09
    satlat:
    63.1811
    satlng:
    34.2174
    satalt:
    32383.0686
  7. satid:
    8290
    satname:
    COSMOS 766
    intDesignator:
    1975-086F
    launchDate:
    1975-09-17
    satlat:
    68.9977
    satlng:
    17.1824
    satalt:
    1482.3362
  8. satid:
    9591
    satname:
    COSMOS 874
    intDesignator:
    1976-118D
    launchDate:
    1976-12-07
    satlat:
    68.9346
    satlng:
    30.6807
    satalt:
    1499.4537
  9. satid:
    9799
    satname:
    COSMOS 886 DEB *
    intDesignator:
    1976-126Z
    launchDate:
    1976-12-27
    satlat:
    62.8166
    satlng:
    9.2962
    satalt:
    2015.2505
  10. satid:
    9890
    satname:
    COSMOS 862 DEB
    intDesignator:
    1976-105G
    launchDate:
    1976-10-22
    satlat:
    61.7989
    satlng:
    6.1316
    satalt:
    22097.6828
  11. satid:
    10588
    satname:
    COSMOS 981
    intDesignator:
    1978-005F
    launchDate:
    1978-01-10
    satlat:
    67.8997
    satlng:
    6.3966
    satalt:
    1506.1846
  12. satid:
    10714
    satname:
    DELTA 1 DEB
    intDesignator:
    1976-077AK
    launchDate:
    1976-07-29
    satlat:
    71.2022
    satlng:
    26.7864
    satalt:
    1431.7257
  13. satid:
    10936
    satname:
    COSMOS 1019
    intDesignator:
    1978-056G
    launchDate:
    1978-06-07
    satlat:
    67.7661
    satlng:
    17.8479
    satalt:
    1435.5586
  14. satid:
    11690
    satname:
    OPS 5117 (NAVSTAR 5)
    intDesignator:
    1980-011A
    launchDate:
    1980-02-09
    satlat:
    44.9714
    satlng:
    22.4324
    satalt:
    21352.4663
  15. satid:
    11696
    satname:
    COSMOS 1161
    intDesignator:
    1980-012F
    launchDate:
    1980-02-11
    satlat:
    73.4652
    satlng:
    14.8638
    satalt:
    1499.7008
  16. satid:
    11847
    satname:
    SL-6 R/B(2)
    intDesignator:
    1980-050B
    launchDate:
    1980-06-14
    satlat:
    67.0383
    satlng:
    56.9017
    satalt:
    29701.8211
  17. satid:
    12322
    satname:
    COSMOS 1252
    intDesignator:
    1981-022C
    launchDate:
    1981-03-06
    satlat:
    68.0116
    satlng:
    11.3503
    satalt:
    1467.3432
  18. satid:
    12330
    satname:
    KYOKKO 1 DEB
    intDesignator:
    1978-014D
    launchDate:
    1978-02-04
    satlat:
    65.0465
    satlng:
    20.9986
    satalt:
    2696.5409
  19. satid:
    12984
    satname:
    COSMOS 1247 DEB
    intDesignator:
    1981-016F
    launchDate:
    1981-02-19
    satlat:
    67.1696
    satlng:
    66.5955
    satalt:
    19901.2454
  20. satid:
    13012
    satname:
    MOLNIYA 1-52
    intDesignator:
    1981-123A
    launchDate:
    1981-12-23
    satlat:
    61.4714
    satlng:
    70.1664
    satalt:
    35621.9978
  21. satid:
    13480
    satname:
    COSMOS 1275 DEB
    intDesignator:
    1981-053GC
    launchDate:
    1981-06-04
    satlat:
    65.3164
    satlng:
    13.3499
    satalt:
    931.6267
  22. satid:
    13909
    satname:
    SL-6 DEB
    intDesignator:
    1981-088J
    launchDate:
    1981-09-11
    satlat:
    61.1531
    satlng:
    37.2716
    satalt:
    11520.9636
  23. satid:
    14096
    satname:
    DELTA 1 R/B
    intDesignator:
    1983-051B
    launchDate:
    1983-05-26
    satlat:
    66.3644
    satlng:
    23.6815
    satalt:
    1558.916
  24. satid:
    14259
    satname:
    COSMOS 1491 (GLONASS)
    intDesignator:
    1983-084B
    launchDate:
    1983-08-10
    satlat:
    63.6516
    satlng:
    72.3469
    satalt:
    18994.4931
  25. satid:
    14734
    satname:
    COSMOS 1317 DEB
    intDesignator:
    1981-108E
    launchDate:
    1981-10-31
    satlat:
    69.1875
    satlng:
    65.3818
    satalt:
    22606.5273
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.