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-16T19:06:42Z in 0.759 seconds.

info:
category:
ANY
transactionscount:
100
satcount:
123
above:

25 results

  1. satid:
    2531
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014AK
    launchDate:
    1963-05-09
    satlat:
    66.8909
    satlng:
    11.2455
    satalt:
    3662.9488
  2. satid:
    2861
    satname:
    SECOR 9 (EGRS 9)
    intDesignator:
    1967-065A
    launchDate:
    1967-06-29
    satlat:
    60.331
    satlng:
    2.0458
    satalt:
    3858.316
  3. satid:
    4635
    satname:
    COSMOS 375 DEB
    intDesignator:
    1970-091M
    launchDate:
    1970-10-30
    satlat:
    54.6484
    satlng:
    9.2391
    satalt:
    1538.1585
  4. satid:
    4964
    satname:
    COSMOS 397
    intDesignator:
    1971-015A
    launchDate:
    1971-02-25
    satlat:
    64.0689
    satlng:
    16.7465
    satalt:
    1260.0442
  5. satid:
    6660
    satname:
    SL-3 R/B
    intDesignator:
    1973-034B
    launchDate:
    1973-05-29
    satlat:
    56.7543
    satlng:
    6.645
    satalt:
    914.6157
  6. satid:
    6965
    satname:
    COSMOS 614
    intDesignator:
    1973-098A
    launchDate:
    1973-12-04
    satlat:
    60.8075
    satlng:
    8.26
    satalt:
    757.4088
  7. satid:
    7629
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-007D
    launchDate:
    1975-01-30
    satlat:
    64.1033
    satlng:
    41.9453
    satalt:
    32777.9924
  8. satid:
    7938
    satname:
    SSU 1 DEB
    intDesignator:
    1975-051D
    launchDate:
    1975-06-08
    satlat:
    61.7049
    satlng:
    15.3562
    satalt:
    1397.4741
  9. satid:
    9271
    satname:
    TITAN 34B AGENA R/B
    intDesignator:
    1976-080B
    launchDate:
    1976-08-06
    satlat:
    55.4014
    satlng:
    -31.2532
    satalt:
    18440.4001
  10. satid:
    9652
    satname:
    COSMOS 886 DEB
    intDesignator:
    1976-126J
    launchDate:
    1976-12-27
    satlat:
    65.069
    satlng:
    -0.1261
    satalt:
    1967.041
  11. satid:
    10293
    satname:
    SL-8 R/B
    intDesignator:
    1977-079J
    launchDate:
    1977-08-24
    satlat:
    55.9356
    satlng:
    4.8117
    satalt:
    1489.3976
  12. satid:
    10443
    satname:
    COSMOS 839 DEB
    intDesignator:
    1976-067U
    launchDate:
    1976-07-08
    satlat:
    62.6676
    satlng:
    3.0982
    satalt:
    1459.6889
  13. satid:
    10765
    satname:
    DELTA 1 DEB
    intDesignator:
    1976-077BN
    launchDate:
    1976-07-29
    satlat:
    55.2069
    satlng:
    5.7246
    satalt:
    1521.4409
  14. satid:
    10893
    satname:
    OPS 5112 (NAVSTAR 2)
    intDesignator:
    1978-047A
    launchDate:
    1978-05-13
    satlat:
    62.2921
    satlng:
    36.7375
    satalt:
    19021.5806
  15. satid:
    10918
    satname:
    SL-8 R/B
    intDesignator:
    1978-053B
    launchDate:
    1978-05-23
    satlat:
    58.3855
    satlng:
    2.3153
    satalt:
    994.924
  16. satid:
    12827
    satname:
    SL-6 R/B(2)
    intDesignator:
    1981-088F
    launchDate:
    1981-09-11
    satlat:
    59.6404
    satlng:
    47.1989
    satalt:
    13271.0157
  17. satid:
    12980
    satname:
    COSMOS 1325
    intDesignator:
    1981-116F
    launchDate:
    1981-11-28
    satlat:
    58.8318
    satlng:
    22.0861
    satalt:
    1579.2974
  18. satid:
    14191
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-070D
    launchDate:
    1983-07-08
    satlat:
    54.8629
    satlng:
    -33.3364
    satalt:
    34451.5083
  19. satid:
    14512
    satname:
    TANSEI 3 DEB
    intDesignator:
    1977-012K
    launchDate:
    1977-02-19
    satlat:
    65.7856
    satlng:
    0.1121
    satalt:
    3155.0665
  20. satid:
    14894
    satname:
    SL-6 R/B(2)
    intDesignator:
    1984-033D
    launchDate:
    1984-04-04
    satlat:
    52.9609
    satlng:
    -7.4688
    satalt:
    31324.5979
  21. satid:
    15227
    satname:
    TITAN 34B R/B
    intDesignator:
    1984-091B
    launchDate:
    1984-08-28
    satlat:
    58.3163
    satlng:
    -25.9192
    satalt:
    32801.0844
  22. satid:
    15266
    satname:
    SL-12 R/B(AUX MOTOR)
    intDesignator:
    1984-095H
    launchDate:
    1984-09-04
    satlat:
    51.6768
    satlng:
    26.807
    satalt:
    11408.6002
  23. satid:
    15272
    satname:
    ATLAS 14E R/B
    intDesignator:
    1984-097B
    launchDate:
    1984-09-08
    satlat:
    58.8779
    satlng:
    3.7791
    satalt:
    16218.119
  24. satid:
    15741
    satname:
    SL-6 R/B(2)
    intDesignator:
    1985-040D
    launchDate:
    1985-05-29
    satlat:
    60.5218
    satlng:
    27.6306
    satalt:
    40396.0992
  25. satid:
    17018
    satname:
    COSMOS 839 DEB
    intDesignator:
    1976-067BJ
    launchDate:
    1976-07-08
    satlat:
    59.6391
    satlng:
    20.9144
    satalt:
    1369.457
limit:
25
offset:
0
returned:
25
has_more_results:
yes
next_offset:
25
Show all fields in HTML
info:
category:
ANY
transactionscount:
100
satcount:
123
above:

25 results

  1. satid:
    2531
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014AK
    launchDate:
    1963-05-09
    satlat:
    66.8909
    satlng:
    11.2455
    satalt:
    3662.9488
  2. satid:
    2861
    satname:
    SECOR 9 (EGRS 9)
    intDesignator:
    1967-065A
    launchDate:
    1967-06-29
    satlat:
    60.331
    satlng:
    2.0458
    satalt:
    3858.316
  3. satid:
    4635
    satname:
    COSMOS 375 DEB
    intDesignator:
    1970-091M
    launchDate:
    1970-10-30
    satlat:
    54.6484
    satlng:
    9.2391
    satalt:
    1538.1585
  4. satid:
    4964
    satname:
    COSMOS 397
    intDesignator:
    1971-015A
    launchDate:
    1971-02-25
    satlat:
    64.0689
    satlng:
    16.7465
    satalt:
    1260.0442
  5. satid:
    6660
    satname:
    SL-3 R/B
    intDesignator:
    1973-034B
    launchDate:
    1973-05-29
    satlat:
    56.7543
    satlng:
    6.645
    satalt:
    914.6157
  6. satid:
    6965
    satname:
    COSMOS 614
    intDesignator:
    1973-098A
    launchDate:
    1973-12-04
    satlat:
    60.8075
    satlng:
    8.26
    satalt:
    757.4088
  7. satid:
    7629
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-007D
    launchDate:
    1975-01-30
    satlat:
    64.1033
    satlng:
    41.9453
    satalt:
    32777.9924
  8. satid:
    7938
    satname:
    SSU 1 DEB
    intDesignator:
    1975-051D
    launchDate:
    1975-06-08
    satlat:
    61.7049
    satlng:
    15.3562
    satalt:
    1397.4741
  9. satid:
    9271
    satname:
    TITAN 34B AGENA R/B
    intDesignator:
    1976-080B
    launchDate:
    1976-08-06
    satlat:
    55.4014
    satlng:
    -31.2532
    satalt:
    18440.4001
  10. satid:
    9652
    satname:
    COSMOS 886 DEB
    intDesignator:
    1976-126J
    launchDate:
    1976-12-27
    satlat:
    65.069
    satlng:
    -0.1261
    satalt:
    1967.041
  11. satid:
    10293
    satname:
    SL-8 R/B
    intDesignator:
    1977-079J
    launchDate:
    1977-08-24
    satlat:
    55.9356
    satlng:
    4.8117
    satalt:
    1489.3976
  12. satid:
    10443
    satname:
    COSMOS 839 DEB
    intDesignator:
    1976-067U
    launchDate:
    1976-07-08
    satlat:
    62.6676
    satlng:
    3.0982
    satalt:
    1459.6889
  13. satid:
    10765
    satname:
    DELTA 1 DEB
    intDesignator:
    1976-077BN
    launchDate:
    1976-07-29
    satlat:
    55.2069
    satlng:
    5.7246
    satalt:
    1521.4409
  14. satid:
    10893
    satname:
    OPS 5112 (NAVSTAR 2)
    intDesignator:
    1978-047A
    launchDate:
    1978-05-13
    satlat:
    62.2921
    satlng:
    36.7375
    satalt:
    19021.5806
  15. satid:
    10918
    satname:
    SL-8 R/B
    intDesignator:
    1978-053B
    launchDate:
    1978-05-23
    satlat:
    58.3855
    satlng:
    2.3153
    satalt:
    994.924
  16. satid:
    12827
    satname:
    SL-6 R/B(2)
    intDesignator:
    1981-088F
    launchDate:
    1981-09-11
    satlat:
    59.6404
    satlng:
    47.1989
    satalt:
    13271.0157
  17. satid:
    12980
    satname:
    COSMOS 1325
    intDesignator:
    1981-116F
    launchDate:
    1981-11-28
    satlat:
    58.8318
    satlng:
    22.0861
    satalt:
    1579.2974
  18. satid:
    14191
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-070D
    launchDate:
    1983-07-08
    satlat:
    54.8629
    satlng:
    -33.3364
    satalt:
    34451.5083
  19. satid:
    14512
    satname:
    TANSEI 3 DEB
    intDesignator:
    1977-012K
    launchDate:
    1977-02-19
    satlat:
    65.7856
    satlng:
    0.1121
    satalt:
    3155.0665
  20. satid:
    14894
    satname:
    SL-6 R/B(2)
    intDesignator:
    1984-033D
    launchDate:
    1984-04-04
    satlat:
    52.9609
    satlng:
    -7.4688
    satalt:
    31324.5979
  21. satid:
    15227
    satname:
    TITAN 34B R/B
    intDesignator:
    1984-091B
    launchDate:
    1984-08-28
    satlat:
    58.3163
    satlng:
    -25.9192
    satalt:
    32801.0844
  22. satid:
    15266
    satname:
    SL-12 R/B(AUX MOTOR)
    intDesignator:
    1984-095H
    launchDate:
    1984-09-04
    satlat:
    51.6768
    satlng:
    26.807
    satalt:
    11408.6002
  23. satid:
    15272
    satname:
    ATLAS 14E R/B
    intDesignator:
    1984-097B
    launchDate:
    1984-09-08
    satlat:
    58.8779
    satlng:
    3.7791
    satalt:
    16218.119
  24. satid:
    15741
    satname:
    SL-6 R/B(2)
    intDesignator:
    1985-040D
    launchDate:
    1985-05-29
    satlat:
    60.5218
    satlng:
    27.6306
    satalt:
    40396.0992
  25. satid:
    17018
    satname:
    COSMOS 839 DEB
    intDesignator:
    1976-067BJ
    launchDate:
    1976-07-08
    satlat:
    59.6391
    satlng:
    20.9144
    satalt:
    1369.457
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.