Allemannsdata Wiki
Manual search

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-16T07:32:18Z in 0.008 seconds.

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

25 results

  1. satid:
    2933
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014AR
    launchDate:
    1963-05-09
    satlat:
    67.1502
    satlng:
    26.6546
    satalt:
    3690.8503
  2. satid:
    3561
    satname:
    COSMOS 252 DEB
    intDesignator:
    1968-097P
    launchDate:
    1968-11-01
    satlat:
    57.2837
    satlng:
    5.2687
    satalt:
    876.4543
  3. satid:
    3740
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1961-015JB
    launchDate:
    1961-06-29
    satlat:
    58.6117
    satlng:
    11.0561
    satalt:
    894.4993
  4. satid:
    5054
    satname:
    TITAN 34B AGENA D R/B
    intDesignator:
    1971-021B
    launchDate:
    1971-03-21
    satlat:
    60.839
    satlng:
    -23.5105
    satalt:
    33057.184
  5. satid:
    8143
    satname:
    THORAD DELTA 1 DEB
    intDesignator:
    1974-089M
    launchDate:
    1974-11-15
    satlat:
    64.1398
    satlng:
    -6.01
    satalt:
    1550.3256
  6. satid:
    8596
    satname:
    THORAD DELTA 1 DEB
    intDesignator:
    1974-089DK
    launchDate:
    1974-11-15
    satlat:
    60.1825
    satlng:
    11.4729
    satalt:
    1328.3093
  7. satid:
    9895
    satname:
    COSMOS 862 DEB
    intDesignator:
    1976-105M
    launchDate:
    1976-10-22
    satlat:
    65.0018
    satlng:
    -3.7549
    satalt:
    20942.3413
  8. satid:
    10089
    satname:
    SL-6 R/B(2)
    intDesignator:
    1977-047D
    launchDate:
    1977-06-16
    satlat:
    60.6475
    satlng:
    6.7648
    satalt:
    22628.4915
  9. satid:
    10573
    satname:
    COSMOS 970 DEB
    intDesignator:
    1977-121Q
    launchDate:
    1977-12-21
    satlat:
    56.5314
    satlng:
    4.0971
    satalt:
    1103.5196
  10. satid:
    10882
    satname:
    COSMOS 970 DEB
    intDesignator:
    1977-121AD
    launchDate:
    1977-12-21
    satlat:
    59.1857
    satlng:
    8.7047
    satalt:
    890.5765
  11. satid:
    10888
    satname:
    COSMOS 970 DEB
    intDesignator:
    1977-121AK
    launchDate:
    1977-12-21
    satlat:
    57.9854
    satlng:
    9.5578
    satalt:
    1119.9007
  12. satid:
    11909
    satname:
    SL-6 R/B(2)
    intDesignator:
    1980-063D
    launchDate:
    1980-07-18
    satlat:
    58.0218
    satlng:
    0.0444
    satalt:
    37627.282
  13. satid:
    12078
    satname:
    COSMOS 1223
    intDesignator:
    1980-095A
    launchDate:
    1980-11-27
    satlat:
    66.7565
    satlng:
    47.3079
    satalt:
    31954.2937
  14. satid:
    12088
    satname:
    SL-8 R/B
    intDesignator:
    1980-097B
    launchDate:
    1980-12-05
    satlat:
    64.6074
    satlng:
    2.7152
    satalt:
    1007.1181
  15. satid:
    12330
    satname:
    KYOKKO 1 DEB
    intDesignator:
    1978-014D
    launchDate:
    1978-02-04
    satlat:
    65.4557
    satlng:
    5.3216
    satalt:
    2603.9891
  16. satid:
    12933
    satname:
    COSMOS 1317
    intDesignator:
    1981-108A
    launchDate:
    1981-10-31
    satlat:
    69.6561
    satlng:
    40.5827
    satalt:
    21994.4269
  17. satid:
    12992
    satname:
    COSMOS 1247 DEB
    intDesignator:
    1981-016H
    launchDate:
    1981-02-19
    satlat:
    66.9181
    satlng:
    -10.2762
    satalt:
    18116.9388
  18. satid:
    13016
    satname:
    SL-6 R/B(2)
    intDesignator:
    1981-123D
    launchDate:
    1981-12-23
    satlat:
    52.506
    satlng:
    -7.9546
    satalt:
    32300.7229
  19. satid:
    13080
    satname:
    COSMOS 1341
    intDesignator:
    1982-016A
    launchDate:
    1982-03-03
    satlat:
    60.3736
    satlng:
    9.3204
    satalt:
    34675.8349
  20. satid:
    13875
    satname:
    MOLNIYA 3-20
    intDesignator:
    1983-015A
    launchDate:
    1983-03-11
    satlat:
    56.8804
    satlng:
    53.5865
    satalt:
    32538.0909
  21. satid:
    13911
    satname:
    SL-6 DEB
    intDesignator:
    1981-088L
    launchDate:
    1981-09-11
    satlat:
    49.0014
    satlng:
    10.0349
    satalt:
    11869.6519
  22. satid:
    13959
    satname:
    COSMOS 1030 DEB
    intDesignator:
    1978-083G
    launchDate:
    1978-09-06
    satlat:
    66.0232
    satlng:
    34.6351
    satalt:
    30191.4781
  23. satid:
    14238
    satname:
    TITAN 34B AGENA D R/B
    intDesignator:
    1983-078B
    launchDate:
    1983-07-31
    satlat:
    62.7573
    satlng:
    36.7795
    satalt:
    30659.5516
  24. satid:
    14552
    satname:
    SL-14 R/B
    intDesignator:
    1983-122B
    launchDate:
    1983-12-15
    satlat:
    62.8359
    satlng:
    6.1413
    satalt:
    608.7995
  25. satid:
    14734
    satname:
    COSMOS 1317 DEB
    intDesignator:
    1981-108E
    launchDate:
    1981-10-31
    satlat:
    72.5076
    satlng:
    12.4181
    satalt:
    24740.8003
limit:
25
offset:
0
returned:
25
has_more_results:
yes
next_offset:
25
Show all fields in HTML
info:
category:
ANY
transactionscount:
99
satcount:
131
above:

25 results

  1. satid:
    2933
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014AR
    launchDate:
    1963-05-09
    satlat:
    67.1502
    satlng:
    26.6546
    satalt:
    3690.8503
  2. satid:
    3561
    satname:
    COSMOS 252 DEB
    intDesignator:
    1968-097P
    launchDate:
    1968-11-01
    satlat:
    57.2837
    satlng:
    5.2687
    satalt:
    876.4543
  3. satid:
    3740
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1961-015JB
    launchDate:
    1961-06-29
    satlat:
    58.6117
    satlng:
    11.0561
    satalt:
    894.4993
  4. satid:
    5054
    satname:
    TITAN 34B AGENA D R/B
    intDesignator:
    1971-021B
    launchDate:
    1971-03-21
    satlat:
    60.839
    satlng:
    -23.5105
    satalt:
    33057.184
  5. satid:
    8143
    satname:
    THORAD DELTA 1 DEB
    intDesignator:
    1974-089M
    launchDate:
    1974-11-15
    satlat:
    64.1398
    satlng:
    -6.01
    satalt:
    1550.3256
  6. satid:
    8596
    satname:
    THORAD DELTA 1 DEB
    intDesignator:
    1974-089DK
    launchDate:
    1974-11-15
    satlat:
    60.1825
    satlng:
    11.4729
    satalt:
    1328.3093
  7. satid:
    9895
    satname:
    COSMOS 862 DEB
    intDesignator:
    1976-105M
    launchDate:
    1976-10-22
    satlat:
    65.0018
    satlng:
    -3.7549
    satalt:
    20942.3413
  8. satid:
    10089
    satname:
    SL-6 R/B(2)
    intDesignator:
    1977-047D
    launchDate:
    1977-06-16
    satlat:
    60.6475
    satlng:
    6.7648
    satalt:
    22628.4915
  9. satid:
    10573
    satname:
    COSMOS 970 DEB
    intDesignator:
    1977-121Q
    launchDate:
    1977-12-21
    satlat:
    56.5314
    satlng:
    4.0971
    satalt:
    1103.5196
  10. satid:
    10882
    satname:
    COSMOS 970 DEB
    intDesignator:
    1977-121AD
    launchDate:
    1977-12-21
    satlat:
    59.1857
    satlng:
    8.7047
    satalt:
    890.5765
  11. satid:
    10888
    satname:
    COSMOS 970 DEB
    intDesignator:
    1977-121AK
    launchDate:
    1977-12-21
    satlat:
    57.9854
    satlng:
    9.5578
    satalt:
    1119.9007
  12. satid:
    11909
    satname:
    SL-6 R/B(2)
    intDesignator:
    1980-063D
    launchDate:
    1980-07-18
    satlat:
    58.0218
    satlng:
    0.0444
    satalt:
    37627.282
  13. satid:
    12078
    satname:
    COSMOS 1223
    intDesignator:
    1980-095A
    launchDate:
    1980-11-27
    satlat:
    66.7565
    satlng:
    47.3079
    satalt:
    31954.2937
  14. satid:
    12088
    satname:
    SL-8 R/B
    intDesignator:
    1980-097B
    launchDate:
    1980-12-05
    satlat:
    64.6074
    satlng:
    2.7152
    satalt:
    1007.1181
  15. satid:
    12330
    satname:
    KYOKKO 1 DEB
    intDesignator:
    1978-014D
    launchDate:
    1978-02-04
    satlat:
    65.4557
    satlng:
    5.3216
    satalt:
    2603.9891
  16. satid:
    12933
    satname:
    COSMOS 1317
    intDesignator:
    1981-108A
    launchDate:
    1981-10-31
    satlat:
    69.6561
    satlng:
    40.5827
    satalt:
    21994.4269
  17. satid:
    12992
    satname:
    COSMOS 1247 DEB
    intDesignator:
    1981-016H
    launchDate:
    1981-02-19
    satlat:
    66.9181
    satlng:
    -10.2762
    satalt:
    18116.9388
  18. satid:
    13016
    satname:
    SL-6 R/B(2)
    intDesignator:
    1981-123D
    launchDate:
    1981-12-23
    satlat:
    52.506
    satlng:
    -7.9546
    satalt:
    32300.7229
  19. satid:
    13080
    satname:
    COSMOS 1341
    intDesignator:
    1982-016A
    launchDate:
    1982-03-03
    satlat:
    60.3736
    satlng:
    9.3204
    satalt:
    34675.8349
  20. satid:
    13875
    satname:
    MOLNIYA 3-20
    intDesignator:
    1983-015A
    launchDate:
    1983-03-11
    satlat:
    56.8804
    satlng:
    53.5865
    satalt:
    32538.0909
  21. satid:
    13911
    satname:
    SL-6 DEB
    intDesignator:
    1981-088L
    launchDate:
    1981-09-11
    satlat:
    49.0014
    satlng:
    10.0349
    satalt:
    11869.6519
  22. satid:
    13959
    satname:
    COSMOS 1030 DEB
    intDesignator:
    1978-083G
    launchDate:
    1978-09-06
    satlat:
    66.0232
    satlng:
    34.6351
    satalt:
    30191.4781
  23. satid:
    14238
    satname:
    TITAN 34B AGENA D R/B
    intDesignator:
    1983-078B
    launchDate:
    1983-07-31
    satlat:
    62.7573
    satlng:
    36.7795
    satalt:
    30659.5516
  24. satid:
    14552
    satname:
    SL-14 R/B
    intDesignator:
    1983-122B
    launchDate:
    1983-12-15
    satlat:
    62.8359
    satlng:
    6.1413
    satalt:
    608.7995
  25. satid:
    14734
    satname:
    COSMOS 1317 DEB
    intDesignator:
    1981-108E
    launchDate:
    1981-10-31
    satlat:
    72.5076
    satlng:
    12.4181
    satalt:
    24740.8003
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.

AI agent? Read the complete navigation and programming guide.