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-09-26T20:08:34Z in 0.691 seconds.

info:
category:
ANY
transactionscount:
72
satcount:
122
above:

25 results

  1. satid:
    516
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1961-015FT
    launchDate:
    1961-06-29
    satlat:
    63.16
    satlng:
    3.1626
    satalt:
    876.9763
  2. satid:
    658
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1961-015HK
    launchDate:
    1961-06-29
    satlat:
    63.6178
    satlng:
    12.1343
    satalt:
    1099.5552
  3. satid:
    2933
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014AR
    launchDate:
    1963-05-09
    satlat:
    54.4864
    satlng:
    21.5547
    satalt:
    3441.8861
  4. satid:
    3686
    satname:
    COSMOS 252 DEB *
    intDesignator:
    1968-097AD
    launchDate:
    1968-11-01
    satlat:
    58.7903
    satlng:
    13.7012
    satalt:
    1161.7385
  5. satid:
    7629
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-007D
    launchDate:
    1975-01-30
    satlat:
    68.7417
    satlng:
    18.1716
    satalt:
    30004.243
  6. satid:
    7687
    satname:
    OPS 2439
    intDesignator:
    1975-017A
    launchDate:
    1975-03-10
    satlat:
    53.2047
    satlng:
    -23.3721
    satalt:
    29525.328
  7. satid:
    9896
    satname:
    COSMOS 862 DEB
    intDesignator:
    1976-105N
    launchDate:
    1976-10-22
    satlat:
    67.4275
    satlng:
    -18.2235
    satalt:
    33841.1792
  8. satid:
    10155
    satname:
    SL-6 R/B(2)
    intDesignator:
    1977-054D
    launchDate:
    1977-06-24
    satlat:
    61.2843
    satlng:
    1.5017
    satalt:
    31053.0411
  9. satid:
    10439
    satname:
    COSMOS 839 DEB
    intDesignator:
    1976-067Q
    launchDate:
    1976-07-08
    satlat:
    63.2403
    satlng:
    11.7305
    satalt:
    1484.6
  10. satid:
    10762
    satname:
    DELTA 1 DEB
    intDesignator:
    1976-077BK
    launchDate:
    1976-07-29
    satlat:
    64.2767
    satlng:
    2.4912
    satalt:
    1806.6468
  11. satid:
    10768
    satname:
    DELTA 1 DEB
    intDesignator:
    1976-077BR
    launchDate:
    1976-07-29
    satlat:
    63.5954
    satlng:
    8.7794
    satalt:
    1539.8535
  12. satid:
    11783
    satname:
    OPS 5118 (NAVSTAR 6)
    intDesignator:
    1980-032A
    launchDate:
    1980-04-26
    satlat:
    61.6475
    satlng:
    34.2887
    satalt:
    18821.4801
  13. satid:
    12112
    satname:
    COSMOS 1233
    intDesignator:
    1980-102F
    launchDate:
    1980-12-23
    satlat:
    65.2287
    satlng:
    7.9867
    satalt:
    1457.1751
  14. satid:
    12329
    satname:
    KYOKKO 1 DEB
    intDesignator:
    1978-014C
    launchDate:
    1978-02-04
    satlat:
    61.4368
    satlng:
    9.2827
    satalt:
    2545.0934
  15. satid:
    13882
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-015E
    launchDate:
    1983-03-11
    satlat:
    57.0562
    satlng:
    24.7012
    satalt:
    34884.9903
  16. satid:
    13890
    satname:
    MOLNIYA 1-56
    intDesignator:
    1983-019A
    launchDate:
    1983-03-16
    satlat:
    61.953
    satlng:
    -46.2635
    satalt:
    38792.003
  17. satid:
    13897
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-019D
    launchDate:
    1983-03-16
    satlat:
    60.1075
    satlng:
    -1.0494
    satalt:
    38826.1032
  18. satid:
    14182
    satname:
    COSMOS 1481
    intDesignator:
    1983-070A
    launchDate:
    1983-07-08
    satlat:
    70.3743
    satlng:
    23.7041
    satalt:
    23854.713
  19. satid:
    14190
    satname:
    ATLAS 75E R/B
    intDesignator:
    1983-072B
    launchDate:
    1983-07-14
    satlat:
    62.0662
    satlng:
    33.8063
    satalt:
    8095.5133
  20. satid:
    14613
    satname:
    COSMOS 1524
    intDesignator:
    1984-001C
    launchDate:
    1984-01-05
    satlat:
    66.855
    satlng:
    6.933
    satalt:
    1442.8003
  21. satid:
    14908
    satname:
    DELTA 1 DEB
    intDesignator:
    1978-026GH
    launchDate:
    1978-03-05
    satlat:
    62.9708
    satlng:
    9.6995
    satalt:
    908.6184
  22. satid:
    15223
    satname:
    SL-6 R/B(2)
    intDesignator:
    1984-089D
    launchDate:
    1984-08-24
    satlat:
    62.1762
    satlng:
    8.802
    satalt:
    34829.823
  23. satid:
    15741
    satname:
    SL-6 R/B(2)
    intDesignator:
    1985-040D
    launchDate:
    1985-05-29
    satlat:
    42.2563
    satlng:
    -6.5142
    satalt:
    27390.7423
  24. satid:
    17328
    satname:
    MOLNIYA 3-31
    intDesignator:
    1987-008A
    launchDate:
    1987-01-22
    satlat:
    60.6867
    satlng:
    57.1381
    satalt:
    34698.5301
  25. satid:
    17506
    satname:
    USA 21
    intDesignator:
    1987-015A
    launchDate:
    1987-02-12
    satlat:
    58.3692
    satlng:
    56.9364
    satalt:
    38035.2155
limit:
25
offset:
0
returned:
25
has_more_results:
yes
truncated:
yes
next_offset:
25
Show all fields in HTML
info:
category:
ANY
transactionscount:
72
satcount:
122
above:

25 results

  1. satid:
    516
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1961-015FT
    launchDate:
    1961-06-29
    satlat:
    63.16
    satlng:
    3.1626
    satalt:
    876.9763
  2. satid:
    658
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1961-015HK
    launchDate:
    1961-06-29
    satlat:
    63.6178
    satlng:
    12.1343
    satalt:
    1099.5552
  3. satid:
    2933
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014AR
    launchDate:
    1963-05-09
    satlat:
    54.4864
    satlng:
    21.5547
    satalt:
    3441.8861
  4. satid:
    3686
    satname:
    COSMOS 252 DEB *
    intDesignator:
    1968-097AD
    launchDate:
    1968-11-01
    satlat:
    58.7903
    satlng:
    13.7012
    satalt:
    1161.7385
  5. satid:
    7629
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-007D
    launchDate:
    1975-01-30
    satlat:
    68.7417
    satlng:
    18.1716
    satalt:
    30004.243
  6. satid:
    7687
    satname:
    OPS 2439
    intDesignator:
    1975-017A
    launchDate:
    1975-03-10
    satlat:
    53.2047
    satlng:
    -23.3721
    satalt:
    29525.328
  7. satid:
    9896
    satname:
    COSMOS 862 DEB
    intDesignator:
    1976-105N
    launchDate:
    1976-10-22
    satlat:
    67.4275
    satlng:
    -18.2235
    satalt:
    33841.1792
  8. satid:
    10155
    satname:
    SL-6 R/B(2)
    intDesignator:
    1977-054D
    launchDate:
    1977-06-24
    satlat:
    61.2843
    satlng:
    1.5017
    satalt:
    31053.0411
  9. satid:
    10439
    satname:
    COSMOS 839 DEB
    intDesignator:
    1976-067Q
    launchDate:
    1976-07-08
    satlat:
    63.2403
    satlng:
    11.7305
    satalt:
    1484.6
  10. satid:
    10762
    satname:
    DELTA 1 DEB
    intDesignator:
    1976-077BK
    launchDate:
    1976-07-29
    satlat:
    64.2767
    satlng:
    2.4912
    satalt:
    1806.6468
  11. satid:
    10768
    satname:
    DELTA 1 DEB
    intDesignator:
    1976-077BR
    launchDate:
    1976-07-29
    satlat:
    63.5954
    satlng:
    8.7794
    satalt:
    1539.8535
  12. satid:
    11783
    satname:
    OPS 5118 (NAVSTAR 6)
    intDesignator:
    1980-032A
    launchDate:
    1980-04-26
    satlat:
    61.6475
    satlng:
    34.2887
    satalt:
    18821.4801
  13. satid:
    12112
    satname:
    COSMOS 1233
    intDesignator:
    1980-102F
    launchDate:
    1980-12-23
    satlat:
    65.2287
    satlng:
    7.9867
    satalt:
    1457.1751
  14. satid:
    12329
    satname:
    KYOKKO 1 DEB
    intDesignator:
    1978-014C
    launchDate:
    1978-02-04
    satlat:
    61.4368
    satlng:
    9.2827
    satalt:
    2545.0934
  15. satid:
    13882
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-015E
    launchDate:
    1983-03-11
    satlat:
    57.0562
    satlng:
    24.7012
    satalt:
    34884.9903
  16. satid:
    13890
    satname:
    MOLNIYA 1-56
    intDesignator:
    1983-019A
    launchDate:
    1983-03-16
    satlat:
    61.953
    satlng:
    -46.2635
    satalt:
    38792.003
  17. satid:
    13897
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-019D
    launchDate:
    1983-03-16
    satlat:
    60.1075
    satlng:
    -1.0494
    satalt:
    38826.1032
  18. satid:
    14182
    satname:
    COSMOS 1481
    intDesignator:
    1983-070A
    launchDate:
    1983-07-08
    satlat:
    70.3743
    satlng:
    23.7041
    satalt:
    23854.713
  19. satid:
    14190
    satname:
    ATLAS 75E R/B
    intDesignator:
    1983-072B
    launchDate:
    1983-07-14
    satlat:
    62.0662
    satlng:
    33.8063
    satalt:
    8095.5133
  20. satid:
    14613
    satname:
    COSMOS 1524
    intDesignator:
    1984-001C
    launchDate:
    1984-01-05
    satlat:
    66.855
    satlng:
    6.933
    satalt:
    1442.8003
  21. satid:
    14908
    satname:
    DELTA 1 DEB
    intDesignator:
    1978-026GH
    launchDate:
    1978-03-05
    satlat:
    62.9708
    satlng:
    9.6995
    satalt:
    908.6184
  22. satid:
    15223
    satname:
    SL-6 R/B(2)
    intDesignator:
    1984-089D
    launchDate:
    1984-08-24
    satlat:
    62.1762
    satlng:
    8.802
    satalt:
    34829.823
  23. satid:
    15741
    satname:
    SL-6 R/B(2)
    intDesignator:
    1985-040D
    launchDate:
    1985-05-29
    satlat:
    42.2563
    satlng:
    -6.5142
    satalt:
    27390.7423
  24. satid:
    17328
    satname:
    MOLNIYA 3-31
    intDesignator:
    1987-008A
    launchDate:
    1987-01-22
    satlat:
    60.6867
    satlng:
    57.1381
    satalt:
    34698.5301
  25. satid:
    17506
    satname:
    USA 21
    intDesignator:
    1987-015A
    launchDate:
    1987-02-12
    satlat:
    58.3692
    satlng:
    56.9364
    satalt:
    38035.2155
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.

AI agent? Read the complete navigation and programming guide.