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-18T18:29:23Z in 0.657 seconds.

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

25 results

  1. satid:
    467
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1961-015FD
    launchDate:
    1961-06-29
    satlat:
    54.7716
    satlng:
    -2.6596
    satalt:
    1155.7095
  2. satid:
    2647
    satname:
    SL-8 DEB
    intDesignator:
    1965-073L
    launchDate:
    1965-09-18
    satlat:
    55.8932
    satlng:
    12.9024
    satalt:
    1601.6652
  3. satid:
    2940
    satname:
    THOR BURNER 2 R/B
    intDesignator:
    1967-080B
    launchDate:
    1967-08-23
    satlat:
    57.9414
    satlng:
    2.7694
    satalt:
    843.4842
  4. satid:
    4895
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1969-082HE
    launchDate:
    1969-09-30
    satlat:
    57.8386
    satlng:
    -2.2195
    satalt:
    731.049
  5. satid:
    5214
    satname:
    COSMOS 415
    intDesignator:
    1971-041E
    launchDate:
    1971-05-07
    satlat:
    57.8861
    satlng:
    5.5904
    satalt:
    1475.324
  6. satid:
    5217
    satname:
    COSMOS 418
    intDesignator:
    1971-041H
    launchDate:
    1971-05-07
    satlat:
    58.8436
    satlng:
    9.5001
    satalt:
    1409.5586
  7. satid:
    5547
    satname:
    COSMOS 444
    intDesignator:
    1971-086A
    launchDate:
    1971-10-13
    satlat:
    58.0674
    satlng:
    5.6021
    satalt:
    1466.9926
  8. satid:
    6302
    satname:
    SL-6 R/B(2)
    intDesignator:
    1972-072E
    launchDate:
    1972-09-19
    satlat:
    36.2909
    satlng:
    9.4312
    satalt:
    24857.4766
  9. satid:
    7629
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-007D
    launchDate:
    1975-01-30
    satlat:
    66.6643
    satlng:
    38.6112
    satalt:
    31830.5107
  10. satid:
    8890
    satname:
    COSMOS 826
    intDesignator:
    1976-054B
    launchDate:
    1976-06-15
    satlat:
    56.8403
    satlng:
    -0.1466
    satalt:
    1552.8493
  11. satid:
    9271
    satname:
    TITAN 34B AGENA R/B
    intDesignator:
    1976-080B
    launchDate:
    1976-08-06
    satlat:
    63.738
    satlng:
    30.0346
    satalt:
    28419.5869
  12. satid:
    9983
    satname:
    TANSEI 3 DEB
    intDesignator:
    1977-012G
    launchDate:
    1977-02-19
    satlat:
    64.9438
    satlng:
    1.3716
    satalt:
    2930.8911
  13. satid:
    10613
    satname:
    COSMOS 839 DEB
    intDesignator:
    1976-067AM
    launchDate:
    1976-07-08
    satlat:
    56.3032
    satlng:
    0.7951
    satalt:
    932.9766
  14. satid:
    10893
    satname:
    OPS 5112 (NAVSTAR 2)
    intDesignator:
    1978-047A
    launchDate:
    1978-05-13
    satlat:
    60.2325
    satlng:
    28.5119
    satalt:
    18903.6072
  15. satid:
    11543
    satname:
    COSMOS 1135
    intDesignator:
    1979-084F
    launchDate:
    1979-09-25
    satlat:
    56.2256
    satlng:
    5.8737
    satalt:
    1471.2142
  16. satid:
    12655
    satname:
    COSMOS 1275 DEB
    intDesignator:
    1981-053K
    launchDate:
    1981-06-04
    satlat:
    60.8003
    satlng:
    2.8842
    satalt:
    964.9684
  17. satid:
    12827
    satname:
    SL-6 R/B(2)
    intDesignator:
    1981-088F
    launchDate:
    1981-09-11
    satlat:
    44.3495
    satlng:
    22.6406
    satalt:
    13410.8313
  18. satid:
    14191
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-070D
    launchDate:
    1983-07-08
    satlat:
    56.3243
    satlng:
    -24.1674
    satalt:
    34504.3838
  19. satid:
    14894
    satname:
    SL-6 R/B(2)
    intDesignator:
    1984-033D
    launchDate:
    1984-04-04
    satlat:
    55.7607
    satlng:
    3.1223
    satalt:
    30201.8959
  20. satid:
    15227
    satname:
    TITAN 34B R/B
    intDesignator:
    1984-091B
    launchDate:
    1984-08-28
    satlat:
    62.2995
    satlng:
    0.6569
    satalt:
    36894.1326
  21. satid:
    15741
    satname:
    SL-6 R/B(2)
    intDesignator:
    1985-040D
    launchDate:
    1985-05-29
    satlat:
    56.7763
    satlng:
    18.706
    satalt:
    38901.3016
  22. satid:
    16393
    satname:
    MOLNIYA 3-27
    intDesignator:
    1985-117A
    launchDate:
    1985-12-24
    satlat:
    61.7813
    satlng:
    -1.6886
    satalt:
    31878.7546
  23. satid:
    18598
    satname:
    SL-6 DEB
    intDesignator:
    1981-088N
    launchDate:
    1981-09-11
    satlat:
    50.462
    satlng:
    13.2346
    satalt:
    4705.849
  24. satid:
    18949
    satname:
    SL-6 R/B(2)
    intDesignator:
    1988-017D
    launchDate:
    1988-03-11
    satlat:
    49.8601
    satlng:
    14.661
    satalt:
    22418.9173
  25. satid:
    19807
    satname:
    MOLNIYA 1-75
    intDesignator:
    1989-014A
    launchDate:
    1989-02-15
    satlat:
    50.4022
    satlng:
    -35.1029
    satalt:
    20444.5414
limit:
25
offset:
0
returned:
25
has_more_results:
yes
next_offset:
25
Show all fields in HTML
info:
category:
ANY
transactionscount:
87
satcount:
104
above:

25 results

  1. satid:
    467
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1961-015FD
    launchDate:
    1961-06-29
    satlat:
    54.7716
    satlng:
    -2.6596
    satalt:
    1155.7095
  2. satid:
    2647
    satname:
    SL-8 DEB
    intDesignator:
    1965-073L
    launchDate:
    1965-09-18
    satlat:
    55.8932
    satlng:
    12.9024
    satalt:
    1601.6652
  3. satid:
    2940
    satname:
    THOR BURNER 2 R/B
    intDesignator:
    1967-080B
    launchDate:
    1967-08-23
    satlat:
    57.9414
    satlng:
    2.7694
    satalt:
    843.4842
  4. satid:
    4895
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1969-082HE
    launchDate:
    1969-09-30
    satlat:
    57.8386
    satlng:
    -2.2195
    satalt:
    731.049
  5. satid:
    5214
    satname:
    COSMOS 415
    intDesignator:
    1971-041E
    launchDate:
    1971-05-07
    satlat:
    57.8861
    satlng:
    5.5904
    satalt:
    1475.324
  6. satid:
    5217
    satname:
    COSMOS 418
    intDesignator:
    1971-041H
    launchDate:
    1971-05-07
    satlat:
    58.8436
    satlng:
    9.5001
    satalt:
    1409.5586
  7. satid:
    5547
    satname:
    COSMOS 444
    intDesignator:
    1971-086A
    launchDate:
    1971-10-13
    satlat:
    58.0674
    satlng:
    5.6021
    satalt:
    1466.9926
  8. satid:
    6302
    satname:
    SL-6 R/B(2)
    intDesignator:
    1972-072E
    launchDate:
    1972-09-19
    satlat:
    36.2909
    satlng:
    9.4312
    satalt:
    24857.4766
  9. satid:
    7629
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-007D
    launchDate:
    1975-01-30
    satlat:
    66.6643
    satlng:
    38.6112
    satalt:
    31830.5107
  10. satid:
    8890
    satname:
    COSMOS 826
    intDesignator:
    1976-054B
    launchDate:
    1976-06-15
    satlat:
    56.8403
    satlng:
    -0.1466
    satalt:
    1552.8493
  11. satid:
    9271
    satname:
    TITAN 34B AGENA R/B
    intDesignator:
    1976-080B
    launchDate:
    1976-08-06
    satlat:
    63.738
    satlng:
    30.0346
    satalt:
    28419.5869
  12. satid:
    9983
    satname:
    TANSEI 3 DEB
    intDesignator:
    1977-012G
    launchDate:
    1977-02-19
    satlat:
    64.9438
    satlng:
    1.3716
    satalt:
    2930.8911
  13. satid:
    10613
    satname:
    COSMOS 839 DEB
    intDesignator:
    1976-067AM
    launchDate:
    1976-07-08
    satlat:
    56.3032
    satlng:
    0.7951
    satalt:
    932.9766
  14. satid:
    10893
    satname:
    OPS 5112 (NAVSTAR 2)
    intDesignator:
    1978-047A
    launchDate:
    1978-05-13
    satlat:
    60.2325
    satlng:
    28.5119
    satalt:
    18903.6072
  15. satid:
    11543
    satname:
    COSMOS 1135
    intDesignator:
    1979-084F
    launchDate:
    1979-09-25
    satlat:
    56.2256
    satlng:
    5.8737
    satalt:
    1471.2142
  16. satid:
    12655
    satname:
    COSMOS 1275 DEB
    intDesignator:
    1981-053K
    launchDate:
    1981-06-04
    satlat:
    60.8003
    satlng:
    2.8842
    satalt:
    964.9684
  17. satid:
    12827
    satname:
    SL-6 R/B(2)
    intDesignator:
    1981-088F
    launchDate:
    1981-09-11
    satlat:
    44.3495
    satlng:
    22.6406
    satalt:
    13410.8313
  18. satid:
    14191
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-070D
    launchDate:
    1983-07-08
    satlat:
    56.3243
    satlng:
    -24.1674
    satalt:
    34504.3838
  19. satid:
    14894
    satname:
    SL-6 R/B(2)
    intDesignator:
    1984-033D
    launchDate:
    1984-04-04
    satlat:
    55.7607
    satlng:
    3.1223
    satalt:
    30201.8959
  20. satid:
    15227
    satname:
    TITAN 34B R/B
    intDesignator:
    1984-091B
    launchDate:
    1984-08-28
    satlat:
    62.2995
    satlng:
    0.6569
    satalt:
    36894.1326
  21. satid:
    15741
    satname:
    SL-6 R/B(2)
    intDesignator:
    1985-040D
    launchDate:
    1985-05-29
    satlat:
    56.7763
    satlng:
    18.706
    satalt:
    38901.3016
  22. satid:
    16393
    satname:
    MOLNIYA 3-27
    intDesignator:
    1985-117A
    launchDate:
    1985-12-24
    satlat:
    61.7813
    satlng:
    -1.6886
    satalt:
    31878.7546
  23. satid:
    18598
    satname:
    SL-6 DEB
    intDesignator:
    1981-088N
    launchDate:
    1981-09-11
    satlat:
    50.462
    satlng:
    13.2346
    satalt:
    4705.849
  24. satid:
    18949
    satname:
    SL-6 R/B(2)
    intDesignator:
    1988-017D
    launchDate:
    1988-03-11
    satlat:
    49.8601
    satlng:
    14.661
    satalt:
    22418.9173
  25. satid:
    19807
    satname:
    MOLNIYA 1-75
    intDesignator:
    1989-014A
    launchDate:
    1989-02-15
    satlat:
    50.4022
    satlng:
    -35.1029
    satalt:
    20444.5414
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.