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-25T10:05:46Z in 0.691 seconds.

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

25 results

  1. satid:
    655
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1961-015HG
    launchDate:
    1961-06-29
    satlat:
    56.6977
    satlng:
    16.6412
    satalt:
    1433.148
  2. satid:
    746
    satname:
    ELEKTRON 1
    intDesignator:
    1964-006A
    launchDate:
    1964-01-30
    satlat:
    60.8187
    satlng:
    -19.609
    satalt:
    6050.8983
  3. satid:
    2255
    satname:
    THOR AGENA D R/B
    intDesignator:
    1966-056B
    launchDate:
    1966-06-24
    satlat:
    60.3498
    satlng:
    19.8306
    satalt:
    4201.0214
  4. satid:
    2377
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014X
    launchDate:
    1963-05-09
    satlat:
    64.761
    satlng:
    4.4922
    satalt:
    3748.1956
  5. satid:
    3093
    satname:
    EXPLORER 36 (GEOS 2)
    intDesignator:
    1968-002A
    launchDate:
    1968-01-11
    satlat:
    61.6235
    satlng:
    13.4724
    satalt:
    1465.825
  6. satid:
    4719
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025CD
    launchDate:
    1970-04-08
    satlat:
    61.4212
    satlng:
    15.9186
    satalt:
    1003.0636
  7. satid:
    6319
    satname:
    COSMOS 539
    intDesignator:
    1972-102A
    launchDate:
    1972-12-21
    satlat:
    63.0353
    satlng:
    7.727
    satalt:
    1381.8804
  8. satid:
    7273
    satname:
    SL-8 R/B
    intDesignator:
    1974-024J
    launchDate:
    1974-04-23
    satlat:
    55.6452
    satlng:
    11.5964
    satalt:
    1566.8286
  9. satid:
    7688
    satname:
    TITAN 34B R/B
    intDesignator:
    1975-017B
    launchDate:
    1975-03-10
    satlat:
    63.3052
    satlng:
    35.653
    satalt:
    15042.7337
  10. satid:
    8601
    satname:
    MOLNIYA 1-32
    intDesignator:
    1976-006A
    launchDate:
    1976-01-22
    satlat:
    55.4941
    satlng:
    15.2813
    satalt:
    29111.4568
  11. satid:
    11051
    satname:
    SL-8 R/B
    intDesignator:
    1978-091J
    launchDate:
    1978-10-04
    satlat:
    62.852
    satlng:
    17.2369
    satalt:
    1547.4062
  12. satid:
    11076
    satname:
    SL-6 R/B(2)
    intDesignator:
    1978-083D
    launchDate:
    1978-09-06
    satlat:
    63.6672
    satlng:
    33.0019
    satalt:
    6843.0133
  13. satid:
    11705
    satname:
    ATLAS 35F R/B
    intDesignator:
    1980-011B
    launchDate:
    1980-02-09
    satlat:
    53.3452
    satlng:
    21.5173
    satalt:
    14887.7889
  14. satid:
    11847
    satname:
    SL-6 R/B(2)
    intDesignator:
    1980-050B
    launchDate:
    1980-06-14
    satlat:
    54.2158
    satlng:
    -12.7583
    satalt:
    36334.2865
  15. satid:
    11909
    satname:
    SL-6 R/B(2)
    intDesignator:
    1980-063D
    launchDate:
    1980-07-18
    satlat:
    61.7473
    satlng:
    -35.9614
    satalt:
    39935.8219
  16. satid:
    12032
    satname:
    COSMOS 1217
    intDesignator:
    1980-085A
    launchDate:
    1980-10-24
    satlat:
    62.8023
    satlng:
    61.4813
    satalt:
    33617.4299
  17. satid:
    12078
    satname:
    COSMOS 1223
    intDesignator:
    1980-095A
    launchDate:
    1980-11-27
    satlat:
    52.5467
    satlng:
    43.936
    satalt:
    32462.2548
  18. satid:
    13075
    satname:
    SL-6 R/B(2)
    intDesignator:
    1982-015D
    launchDate:
    1982-02-26
    satlat:
    62.9616
    satlng:
    35.4721
    satalt:
    39141.901
  19. satid:
    13080
    satname:
    COSMOS 1341
    intDesignator:
    1982-016A
    launchDate:
    1982-03-03
    satlat:
    50.8473
    satlng:
    -3.21
    satalt:
    35314.3165
  20. satid:
    13875
    satname:
    MOLNIYA 3-20
    intDesignator:
    1983-015A
    launchDate:
    1983-03-11
    satlat:
    60.9687
    satlng:
    50.1909
    satalt:
    37264.4996
  21. satid:
    13909
    satname:
    SL-6 DEB
    intDesignator:
    1981-088J
    launchDate:
    1981-09-11
    satlat:
    57.592
    satlng:
    25.9811
    satalt:
    12254.485
  22. satid:
    13910
    satname:
    SL-6 DEB
    intDesignator:
    1981-088K
    launchDate:
    1981-09-11
    satlat:
    57.1373
    satlng:
    -22.9315
    satalt:
    12209.486
  23. satid:
    13961
    satname:
    COSMOS 1285 DEB
    intDesignator:
    1981-071F
    launchDate:
    1981-08-04
    satlat:
    66.702
    satlng:
    43.1048
    satalt:
    22465.2689
  24. satid:
    14736
    satname:
    COSMOS 1317 DEB
    intDesignator:
    1981-108G
    launchDate:
    1981-10-31
    satlat:
    71.2859
    satlng:
    57.5734
    satalt:
    24576.2295
  25. satid:
    15226
    satname:
    USA 4
    intDesignator:
    1984-091A
    launchDate:
    1984-08-28
    satlat:
    63.2024
    satlng:
    13.044
    satalt:
    36096.1162
limit:
25
offset:
0
returned:
25
has_more_results:
yes
truncated:
yes
next_offset:
25
Show all fields in HTML
info:
category:
ANY
transactionscount:
87
satcount:
120
above:

25 results

  1. satid:
    655
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1961-015HG
    launchDate:
    1961-06-29
    satlat:
    56.6977
    satlng:
    16.6412
    satalt:
    1433.148
  2. satid:
    746
    satname:
    ELEKTRON 1
    intDesignator:
    1964-006A
    launchDate:
    1964-01-30
    satlat:
    60.8187
    satlng:
    -19.609
    satalt:
    6050.8983
  3. satid:
    2255
    satname:
    THOR AGENA D R/B
    intDesignator:
    1966-056B
    launchDate:
    1966-06-24
    satlat:
    60.3498
    satlng:
    19.8306
    satalt:
    4201.0214
  4. satid:
    2377
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014X
    launchDate:
    1963-05-09
    satlat:
    64.761
    satlng:
    4.4922
    satalt:
    3748.1956
  5. satid:
    3093
    satname:
    EXPLORER 36 (GEOS 2)
    intDesignator:
    1968-002A
    launchDate:
    1968-01-11
    satlat:
    61.6235
    satlng:
    13.4724
    satalt:
    1465.825
  6. satid:
    4719
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025CD
    launchDate:
    1970-04-08
    satlat:
    61.4212
    satlng:
    15.9186
    satalt:
    1003.0636
  7. satid:
    6319
    satname:
    COSMOS 539
    intDesignator:
    1972-102A
    launchDate:
    1972-12-21
    satlat:
    63.0353
    satlng:
    7.727
    satalt:
    1381.8804
  8. satid:
    7273
    satname:
    SL-8 R/B
    intDesignator:
    1974-024J
    launchDate:
    1974-04-23
    satlat:
    55.6452
    satlng:
    11.5964
    satalt:
    1566.8286
  9. satid:
    7688
    satname:
    TITAN 34B R/B
    intDesignator:
    1975-017B
    launchDate:
    1975-03-10
    satlat:
    63.3052
    satlng:
    35.653
    satalt:
    15042.7337
  10. satid:
    8601
    satname:
    MOLNIYA 1-32
    intDesignator:
    1976-006A
    launchDate:
    1976-01-22
    satlat:
    55.4941
    satlng:
    15.2813
    satalt:
    29111.4568
  11. satid:
    11051
    satname:
    SL-8 R/B
    intDesignator:
    1978-091J
    launchDate:
    1978-10-04
    satlat:
    62.852
    satlng:
    17.2369
    satalt:
    1547.4062
  12. satid:
    11076
    satname:
    SL-6 R/B(2)
    intDesignator:
    1978-083D
    launchDate:
    1978-09-06
    satlat:
    63.6672
    satlng:
    33.0019
    satalt:
    6843.0133
  13. satid:
    11705
    satname:
    ATLAS 35F R/B
    intDesignator:
    1980-011B
    launchDate:
    1980-02-09
    satlat:
    53.3452
    satlng:
    21.5173
    satalt:
    14887.7889
  14. satid:
    11847
    satname:
    SL-6 R/B(2)
    intDesignator:
    1980-050B
    launchDate:
    1980-06-14
    satlat:
    54.2158
    satlng:
    -12.7583
    satalt:
    36334.2865
  15. satid:
    11909
    satname:
    SL-6 R/B(2)
    intDesignator:
    1980-063D
    launchDate:
    1980-07-18
    satlat:
    61.7473
    satlng:
    -35.9614
    satalt:
    39935.8219
  16. satid:
    12032
    satname:
    COSMOS 1217
    intDesignator:
    1980-085A
    launchDate:
    1980-10-24
    satlat:
    62.8023
    satlng:
    61.4813
    satalt:
    33617.4299
  17. satid:
    12078
    satname:
    COSMOS 1223
    intDesignator:
    1980-095A
    launchDate:
    1980-11-27
    satlat:
    52.5467
    satlng:
    43.936
    satalt:
    32462.2548
  18. satid:
    13075
    satname:
    SL-6 R/B(2)
    intDesignator:
    1982-015D
    launchDate:
    1982-02-26
    satlat:
    62.9616
    satlng:
    35.4721
    satalt:
    39141.901
  19. satid:
    13080
    satname:
    COSMOS 1341
    intDesignator:
    1982-016A
    launchDate:
    1982-03-03
    satlat:
    50.8473
    satlng:
    -3.21
    satalt:
    35314.3165
  20. satid:
    13875
    satname:
    MOLNIYA 3-20
    intDesignator:
    1983-015A
    launchDate:
    1983-03-11
    satlat:
    60.9687
    satlng:
    50.1909
    satalt:
    37264.4996
  21. satid:
    13909
    satname:
    SL-6 DEB
    intDesignator:
    1981-088J
    launchDate:
    1981-09-11
    satlat:
    57.592
    satlng:
    25.9811
    satalt:
    12254.485
  22. satid:
    13910
    satname:
    SL-6 DEB
    intDesignator:
    1981-088K
    launchDate:
    1981-09-11
    satlat:
    57.1373
    satlng:
    -22.9315
    satalt:
    12209.486
  23. satid:
    13961
    satname:
    COSMOS 1285 DEB
    intDesignator:
    1981-071F
    launchDate:
    1981-08-04
    satlat:
    66.702
    satlng:
    43.1048
    satalt:
    22465.2689
  24. satid:
    14736
    satname:
    COSMOS 1317 DEB
    intDesignator:
    1981-108G
    launchDate:
    1981-10-31
    satlat:
    71.2859
    satlng:
    57.5734
    satalt:
    24576.2295
  25. satid:
    15226
    satname:
    USA 4
    intDesignator:
    1984-091A
    launchDate:
    1984-08-28
    satlat:
    63.2024
    satlng:
    13.044
    satalt:
    36096.1162
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.