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-20T06:00:31Z in 1.361 seconds.

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

25 results

  1. satid:
    4391
    satname:
    SL-8 R/B
    intDesignator:
    1970-036J
    launchDate:
    1970-04-25
    satlat:
    59.6553
    satlng:
    12.3353
    satalt:
    1504.9827
  2. satid:
    5277
    satname:
    COSMOS 397 DEB
    intDesignator:
    1971-015BE
    launchDate:
    1971-02-25
    satlat:
    56.4128
    satlng:
    3.6128
    satalt:
    1714.7046
  3. satid:
    7688
    satname:
    TITAN 34B R/B
    intDesignator:
    1975-017B
    launchDate:
    1975-03-10
    satlat:
    45.0058
    satlng:
    -0.9991
    satalt:
    10329.691
  4. satid:
    8406
    satname:
    THORAD DELTA 1 DEB
    intDesignator:
    1974-089CJ
    launchDate:
    1974-11-15
    satlat:
    62.3729
    satlng:
    5.9535
    satalt:
    1449.0589
  5. satid:
    8799
    satname:
    METEOR 1-24
    intDesignator:
    1976-032A
    launchDate:
    1976-04-07
    satlat:
    58.934
    satlng:
    2.2142
    satalt:
    885.3151
  6. satid:
    9895
    satname:
    COSMOS 862 DEB
    intDesignator:
    1976-105M
    launchDate:
    1976-10-22
    satlat:
    48.6478
    satlng:
    41.9175
    satalt:
    19852.2973
  7. satid:
    10282
    satname:
    COSMOS 939
    intDesignator:
    1977-079A
    launchDate:
    1977-08-24
    satlat:
    54.6707
    satlng:
    3.0818
    satalt:
    1468.065
  8. satid:
    10445
    satname:
    COSMOS 839 DEB
    intDesignator:
    1976-067W
    launchDate:
    1976-07-08
    satlat:
    55.0671
    satlng:
    0.3658
    satalt:
    2158.4295
  9. satid:
    10529
    satname:
    SS 1
    intDesignator:
    1977-112D
    launchDate:
    1977-12-08
    satlat:
    58.1404
    satlng:
    14.9469
    satalt:
    718.5133
  10. satid:
    10619
    satname:
    COSMOS 839 DEB
    intDesignator:
    1976-067AT
    launchDate:
    1976-07-08
    satlat:
    59.1931
    satlng:
    18.6848
    satalt:
    2036.8482
  11. satid:
    10684
    satname:
    OPS 5111 (NAVSTAR 1)
    intDesignator:
    1978-020A
    launchDate:
    1978-02-22
    satlat:
    64.2772
    satlng:
    11.9555
    satalt:
    20561.9127
  12. satid:
    11909
    satname:
    SL-6 R/B(2)
    intDesignator:
    1980-063D
    launchDate:
    1980-07-18
    satlat:
    63.8724
    satlng:
    -23.705
    satalt:
    39554.935
  13. satid:
    12000
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086GL
    launchDate:
    1973-11-06
    satlat:
    58.3554
    satlng:
    13.554
    satalt:
    1514.5638
  14. satid:
    12078
    satname:
    COSMOS 1223
    intDesignator:
    1980-095A
    launchDate:
    1980-11-27
    satlat:
    72.2746
    satlng:
    35.1205
    satalt:
    30438.7107
  15. satid:
    12933
    satname:
    COSMOS 1317
    intDesignator:
    1981-108A
    launchDate:
    1981-10-31
    satlat:
    49.1709
    satlng:
    11.1046
    satalt:
    15764.328
  16. satid:
    12992
    satname:
    COSMOS 1247 DEB
    intDesignator:
    1981-016H
    launchDate:
    1981-02-19
    satlat:
    65.1311
    satlng:
    8.8756
    satalt:
    19343.0436
  17. satid:
    13080
    satname:
    COSMOS 1341
    intDesignator:
    1982-016A
    launchDate:
    1982-03-03
    satlat:
    65.8801
    satlng:
    9.6049
    satalt:
    33219.2954
  18. satid:
    13610
    satname:
    SL-12 R/B(2)
    intDesignator:
    1982-100H
    launchDate:
    1982-10-12
    satlat:
    62.3871
    satlng:
    5.585
    satalt:
    19079.9394
  19. satid:
    13909
    satname:
    SL-6 DEB
    intDesignator:
    1981-088J
    launchDate:
    1981-09-11
    satlat:
    62.013
    satlng:
    32.1765
    satalt:
    12465.1928
  20. satid:
    13959
    satname:
    COSMOS 1030 DEB
    intDesignator:
    1978-083G
    launchDate:
    1978-09-06
    satlat:
    70.2863
    satlng:
    -10.7631
    satalt:
    25450.9439
  21. satid:
    14000
    satname:
    COSMOS 931 DEB
    intDesignator:
    1977-068G
    launchDate:
    1977-07-20
    satlat:
    68.6519
    satlng:
    55.6195
    satalt:
    18937.4436
  22. satid:
    14734
    satname:
    COSMOS 1317 DEB
    intDesignator:
    1981-108E
    launchDate:
    1981-10-31
    satlat:
    71.3298
    satlng:
    9.5646
    satalt:
    23555.8279
  23. satid:
    14796
    satname:
    SL-6 R/B(2)
    intDesignator:
    1984-024D
    launchDate:
    1984-03-06
    satlat:
    69.4871
    satlng:
    22.185
    satalt:
    18670.6699
  24. satid:
    15226
    satname:
    USA 4
    intDesignator:
    1984-091A
    launchDate:
    1984-08-28
    satlat:
    57.2309
    satlng:
    5.3851
    satalt:
    27345.4194
  25. satid:
    15264
    satname:
    SL-12 R/B(2)
    intDesignator:
    1984-095F
    launchDate:
    1984-09-04
    satlat:
    48.7271
    satlng:
    -18.8388
    satalt:
    19106.7342
limit:
25
offset:
0
returned:
25
has_more_results:
yes
next_offset:
25
Show all fields in HTML
info:
category:
ANY
transactionscount:
99
satcount:
125
above:

25 results

  1. satid:
    4391
    satname:
    SL-8 R/B
    intDesignator:
    1970-036J
    launchDate:
    1970-04-25
    satlat:
    59.6553
    satlng:
    12.3353
    satalt:
    1504.9827
  2. satid:
    5277
    satname:
    COSMOS 397 DEB
    intDesignator:
    1971-015BE
    launchDate:
    1971-02-25
    satlat:
    56.4128
    satlng:
    3.6128
    satalt:
    1714.7046
  3. satid:
    7688
    satname:
    TITAN 34B R/B
    intDesignator:
    1975-017B
    launchDate:
    1975-03-10
    satlat:
    45.0058
    satlng:
    -0.9991
    satalt:
    10329.691
  4. satid:
    8406
    satname:
    THORAD DELTA 1 DEB
    intDesignator:
    1974-089CJ
    launchDate:
    1974-11-15
    satlat:
    62.3729
    satlng:
    5.9535
    satalt:
    1449.0589
  5. satid:
    8799
    satname:
    METEOR 1-24
    intDesignator:
    1976-032A
    launchDate:
    1976-04-07
    satlat:
    58.934
    satlng:
    2.2142
    satalt:
    885.3151
  6. satid:
    9895
    satname:
    COSMOS 862 DEB
    intDesignator:
    1976-105M
    launchDate:
    1976-10-22
    satlat:
    48.6478
    satlng:
    41.9175
    satalt:
    19852.2973
  7. satid:
    10282
    satname:
    COSMOS 939
    intDesignator:
    1977-079A
    launchDate:
    1977-08-24
    satlat:
    54.6707
    satlng:
    3.0818
    satalt:
    1468.065
  8. satid:
    10445
    satname:
    COSMOS 839 DEB
    intDesignator:
    1976-067W
    launchDate:
    1976-07-08
    satlat:
    55.0671
    satlng:
    0.3658
    satalt:
    2158.4295
  9. satid:
    10529
    satname:
    SS 1
    intDesignator:
    1977-112D
    launchDate:
    1977-12-08
    satlat:
    58.1404
    satlng:
    14.9469
    satalt:
    718.5133
  10. satid:
    10619
    satname:
    COSMOS 839 DEB
    intDesignator:
    1976-067AT
    launchDate:
    1976-07-08
    satlat:
    59.1931
    satlng:
    18.6848
    satalt:
    2036.8482
  11. satid:
    10684
    satname:
    OPS 5111 (NAVSTAR 1)
    intDesignator:
    1978-020A
    launchDate:
    1978-02-22
    satlat:
    64.2772
    satlng:
    11.9555
    satalt:
    20561.9127
  12. satid:
    11909
    satname:
    SL-6 R/B(2)
    intDesignator:
    1980-063D
    launchDate:
    1980-07-18
    satlat:
    63.8724
    satlng:
    -23.705
    satalt:
    39554.935
  13. satid:
    12000
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086GL
    launchDate:
    1973-11-06
    satlat:
    58.3554
    satlng:
    13.554
    satalt:
    1514.5638
  14. satid:
    12078
    satname:
    COSMOS 1223
    intDesignator:
    1980-095A
    launchDate:
    1980-11-27
    satlat:
    72.2746
    satlng:
    35.1205
    satalt:
    30438.7107
  15. satid:
    12933
    satname:
    COSMOS 1317
    intDesignator:
    1981-108A
    launchDate:
    1981-10-31
    satlat:
    49.1709
    satlng:
    11.1046
    satalt:
    15764.328
  16. satid:
    12992
    satname:
    COSMOS 1247 DEB
    intDesignator:
    1981-016H
    launchDate:
    1981-02-19
    satlat:
    65.1311
    satlng:
    8.8756
    satalt:
    19343.0436
  17. satid:
    13080
    satname:
    COSMOS 1341
    intDesignator:
    1982-016A
    launchDate:
    1982-03-03
    satlat:
    65.8801
    satlng:
    9.6049
    satalt:
    33219.2954
  18. satid:
    13610
    satname:
    SL-12 R/B(2)
    intDesignator:
    1982-100H
    launchDate:
    1982-10-12
    satlat:
    62.3871
    satlng:
    5.585
    satalt:
    19079.9394
  19. satid:
    13909
    satname:
    SL-6 DEB
    intDesignator:
    1981-088J
    launchDate:
    1981-09-11
    satlat:
    62.013
    satlng:
    32.1765
    satalt:
    12465.1928
  20. satid:
    13959
    satname:
    COSMOS 1030 DEB
    intDesignator:
    1978-083G
    launchDate:
    1978-09-06
    satlat:
    70.2863
    satlng:
    -10.7631
    satalt:
    25450.9439
  21. satid:
    14000
    satname:
    COSMOS 931 DEB
    intDesignator:
    1977-068G
    launchDate:
    1977-07-20
    satlat:
    68.6519
    satlng:
    55.6195
    satalt:
    18937.4436
  22. satid:
    14734
    satname:
    COSMOS 1317 DEB
    intDesignator:
    1981-108E
    launchDate:
    1981-10-31
    satlat:
    71.3298
    satlng:
    9.5646
    satalt:
    23555.8279
  23. satid:
    14796
    satname:
    SL-6 R/B(2)
    intDesignator:
    1984-024D
    launchDate:
    1984-03-06
    satlat:
    69.4871
    satlng:
    22.185
    satalt:
    18670.6699
  24. satid:
    15226
    satname:
    USA 4
    intDesignator:
    1984-091A
    launchDate:
    1984-08-28
    satlat:
    57.2309
    satlng:
    5.3851
    satalt:
    27345.4194
  25. satid:
    15264
    satname:
    SL-12 R/B(2)
    intDesignator:
    1984-095F
    launchDate:
    1984-09-04
    satlat:
    48.7271
    satlng:
    -18.8388
    satalt:
    19106.7342
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.