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-18T06:07:32Z in 0.986 seconds.

info:
category:
ANY
transactionscount:
96
satcount:
143
above:

25 results

  1. satid:
    329
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1961-015DF
    launchDate:
    1961-06-29
    satlat:
    58.2664
    satlng:
    10.9921
    satalt:
    1102.8781
  2. satid:
    655
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1961-015HG
    launchDate:
    1961-06-29
    satlat:
    56.3746
    satlng:
    6.5923
    satalt:
    1370.8005
  3. satid:
    692
    satname:
    VELA 1
    intDesignator:
    1963-039C
    launchDate:
    1963-10-17
    satlat:
    33.5514
    satlng:
    27.9171
    satalt:
    119467.3533
  4. satid:
    746
    satname:
    ELEKTRON 1
    intDesignator:
    1964-006A
    launchDate:
    1964-01-30
    satlat:
    59.6901
    satlng:
    10.9839
    satalt:
    5879.5567
  5. satid:
    1586
    satname:
    COSMOS 88
    intDesignator:
    1965-073C
    launchDate:
    1965-09-18
    satlat:
    56.0438
    satlng:
    19.8107
    satalt:
    1557.9682
  6. satid:
    2622
    satname:
    OV1-9 R/B
    intDesignator:
    1966-111D
    launchDate:
    1966-12-11
    satlat:
    53.9765
    satlng:
    27.5084
    satalt:
    4375.6275
  7. satid:
    2861
    satname:
    SECOR 9 (EGRS 9)
    intDesignator:
    1967-065A
    launchDate:
    1967-06-29
    satlat:
    47.283
    satlng:
    15.302
    satalt:
    3939.2579
  8. satid:
    5222
    satname:
    COSMOS 397 DEB
    intDesignator:
    1971-015AW
    launchDate:
    1971-02-25
    satlat:
    56.9014
    satlng:
    18.3431
    satalt:
    1519.7625
  9. satid:
    5871
    satname:
    COSMOS 252 DEB *
    intDesignator:
    1968-097DK
    launchDate:
    1968-11-01
    satlat:
    62.7044
    satlng:
    9.4298
    satalt:
    1808.2768
  10. satid:
    6214
    satname:
    DELTA 1 DEB
    intDesignator:
    1966-016E
    launchDate:
    1966-02-28
    satlat:
    53.9776
    satlng:
    9.866
    satalt:
    1504.8488
  11. satid:
    8166
    satname:
    THORAD DELTA 1 DEB
    intDesignator:
    1974-089AG
    launchDate:
    1974-11-15
    satlat:
    57.349
    satlng:
    10.0767
    satalt:
    1436.3798
  12. satid:
    8822
    satname:
    LAGEOS 1 AKM
    intDesignator:
    1976-039C
    launchDate:
    1976-05-04
    satlat:
    70.1736
    satlng:
    21.9805
    satalt:
    5957.392
  13. satid:
    9895
    satname:
    COSMOS 862 DEB
    intDesignator:
    1976-105M
    launchDate:
    1976-10-22
    satlat:
    48.6061
    satlng:
    42.3922
    satalt:
    19846.3663
  14. satid:
    9960
    satname:
    COSMOS 886 DEB
    intDesignator:
    1976-126BA
    launchDate:
    1976-12-27
    satlat:
    57.1945
    satlng:
    10.3134
    satalt:
    1886.6829
  15. satid:
    10282
    satname:
    COSMOS 939
    intDesignator:
    1977-079A
    launchDate:
    1977-08-24
    satlat:
    59.6761
    satlng:
    0.5159
    satalt:
    1470.4481
  16. satid:
    10446
    satname:
    COSMOS 839 DEB
    intDesignator:
    1976-067X
    launchDate:
    1976-07-08
    satlat:
    60.2682
    satlng:
    16.1431
    satalt:
    1260.7113
  17. satid:
    10621
    satname:
    COSMOS 839 DEB
    intDesignator:
    1976-067AV
    launchDate:
    1976-07-08
    satlat:
    61.221
    satlng:
    9.749
    satalt:
    1556.3825
  18. satid:
    10684
    satname:
    OPS 5111 (NAVSTAR 1)
    intDesignator:
    1978-020A
    launchDate:
    1978-02-22
    satlat:
    61.198
    satlng:
    49.7476
    satalt:
    20505.941
  19. satid:
    11142
    satname:
    ATLAS F R/B
    intDesignator:
    1978-112B
    launchDate:
    1978-12-11
    satlat:
    44.9454
    satlng:
    -7.5096
    satalt:
    13435.0609
  20. satid:
    11909
    satname:
    SL-6 R/B(2)
    intDesignator:
    1980-063D
    launchDate:
    1980-07-18
    satlat:
    62.9697
    satlng:
    -10.0667
    satalt:
    40223.1695
  21. satid:
    12078
    satname:
    COSMOS 1223
    intDesignator:
    1980-095A
    launchDate:
    1980-11-27
    satlat:
    72.4586
    satlng:
    33.7659
    satalt:
    30322.9205
  22. satid:
    12303
    satname:
    COSMOS 1247
    intDesignator:
    1981-016A
    launchDate:
    1981-02-19
    satlat:
    39.3593
    satlng:
    30.521
    satalt:
    33270.5061
  23. satid:
    12893
    satname:
    COSMOS 1261 DEB
    intDesignator:
    1981-031F
    launchDate:
    1981-03-31
    satlat:
    42.7144
    satlng:
    4.4172
    satalt:
    9536.1592
  24. satid:
    12933
    satname:
    COSMOS 1317
    intDesignator:
    1981-108A
    launchDate:
    1981-10-31
    satlat:
    51.1605
    satlng:
    13.1559
    satalt:
    16180.0906
  25. satid:
    12992
    satname:
    COSMOS 1247 DEB
    intDesignator:
    1981-016H
    launchDate:
    1981-02-19
    satlat:
    69.6123
    satlng:
    -27.8783
    satalt:
    14778.5655
limit:
25
offset:
0
returned:
25
has_more_results:
yes
next_offset:
25
Show all fields in HTML
info:
category:
ANY
transactionscount:
96
satcount:
143
above:

25 results

  1. satid:
    329
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1961-015DF
    launchDate:
    1961-06-29
    satlat:
    58.2664
    satlng:
    10.9921
    satalt:
    1102.8781
  2. satid:
    655
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1961-015HG
    launchDate:
    1961-06-29
    satlat:
    56.3746
    satlng:
    6.5923
    satalt:
    1370.8005
  3. satid:
    692
    satname:
    VELA 1
    intDesignator:
    1963-039C
    launchDate:
    1963-10-17
    satlat:
    33.5514
    satlng:
    27.9171
    satalt:
    119467.3533
  4. satid:
    746
    satname:
    ELEKTRON 1
    intDesignator:
    1964-006A
    launchDate:
    1964-01-30
    satlat:
    59.6901
    satlng:
    10.9839
    satalt:
    5879.5567
  5. satid:
    1586
    satname:
    COSMOS 88
    intDesignator:
    1965-073C
    launchDate:
    1965-09-18
    satlat:
    56.0438
    satlng:
    19.8107
    satalt:
    1557.9682
  6. satid:
    2622
    satname:
    OV1-9 R/B
    intDesignator:
    1966-111D
    launchDate:
    1966-12-11
    satlat:
    53.9765
    satlng:
    27.5084
    satalt:
    4375.6275
  7. satid:
    2861
    satname:
    SECOR 9 (EGRS 9)
    intDesignator:
    1967-065A
    launchDate:
    1967-06-29
    satlat:
    47.283
    satlng:
    15.302
    satalt:
    3939.2579
  8. satid:
    5222
    satname:
    COSMOS 397 DEB
    intDesignator:
    1971-015AW
    launchDate:
    1971-02-25
    satlat:
    56.9014
    satlng:
    18.3431
    satalt:
    1519.7625
  9. satid:
    5871
    satname:
    COSMOS 252 DEB *
    intDesignator:
    1968-097DK
    launchDate:
    1968-11-01
    satlat:
    62.7044
    satlng:
    9.4298
    satalt:
    1808.2768
  10. satid:
    6214
    satname:
    DELTA 1 DEB
    intDesignator:
    1966-016E
    launchDate:
    1966-02-28
    satlat:
    53.9776
    satlng:
    9.866
    satalt:
    1504.8488
  11. satid:
    8166
    satname:
    THORAD DELTA 1 DEB
    intDesignator:
    1974-089AG
    launchDate:
    1974-11-15
    satlat:
    57.349
    satlng:
    10.0767
    satalt:
    1436.3798
  12. satid:
    8822
    satname:
    LAGEOS 1 AKM
    intDesignator:
    1976-039C
    launchDate:
    1976-05-04
    satlat:
    70.1736
    satlng:
    21.9805
    satalt:
    5957.392
  13. satid:
    9895
    satname:
    COSMOS 862 DEB
    intDesignator:
    1976-105M
    launchDate:
    1976-10-22
    satlat:
    48.6061
    satlng:
    42.3922
    satalt:
    19846.3663
  14. satid:
    9960
    satname:
    COSMOS 886 DEB
    intDesignator:
    1976-126BA
    launchDate:
    1976-12-27
    satlat:
    57.1945
    satlng:
    10.3134
    satalt:
    1886.6829
  15. satid:
    10282
    satname:
    COSMOS 939
    intDesignator:
    1977-079A
    launchDate:
    1977-08-24
    satlat:
    59.6761
    satlng:
    0.5159
    satalt:
    1470.4481
  16. satid:
    10446
    satname:
    COSMOS 839 DEB
    intDesignator:
    1976-067X
    launchDate:
    1976-07-08
    satlat:
    60.2682
    satlng:
    16.1431
    satalt:
    1260.7113
  17. satid:
    10621
    satname:
    COSMOS 839 DEB
    intDesignator:
    1976-067AV
    launchDate:
    1976-07-08
    satlat:
    61.221
    satlng:
    9.749
    satalt:
    1556.3825
  18. satid:
    10684
    satname:
    OPS 5111 (NAVSTAR 1)
    intDesignator:
    1978-020A
    launchDate:
    1978-02-22
    satlat:
    61.198
    satlng:
    49.7476
    satalt:
    20505.941
  19. satid:
    11142
    satname:
    ATLAS F R/B
    intDesignator:
    1978-112B
    launchDate:
    1978-12-11
    satlat:
    44.9454
    satlng:
    -7.5096
    satalt:
    13435.0609
  20. satid:
    11909
    satname:
    SL-6 R/B(2)
    intDesignator:
    1980-063D
    launchDate:
    1980-07-18
    satlat:
    62.9697
    satlng:
    -10.0667
    satalt:
    40223.1695
  21. satid:
    12078
    satname:
    COSMOS 1223
    intDesignator:
    1980-095A
    launchDate:
    1980-11-27
    satlat:
    72.4586
    satlng:
    33.7659
    satalt:
    30322.9205
  22. satid:
    12303
    satname:
    COSMOS 1247
    intDesignator:
    1981-016A
    launchDate:
    1981-02-19
    satlat:
    39.3593
    satlng:
    30.521
    satalt:
    33270.5061
  23. satid:
    12893
    satname:
    COSMOS 1261 DEB
    intDesignator:
    1981-031F
    launchDate:
    1981-03-31
    satlat:
    42.7144
    satlng:
    4.4172
    satalt:
    9536.1592
  24. satid:
    12933
    satname:
    COSMOS 1317
    intDesignator:
    1981-108A
    launchDate:
    1981-10-31
    satlat:
    51.1605
    satlng:
    13.1559
    satalt:
    16180.0906
  25. satid:
    12992
    satname:
    COSMOS 1247 DEB
    intDesignator:
    1981-016H
    launchDate:
    1981-02-19
    satlat:
    69.6123
    satlng:
    -27.8783
    satalt:
    14778.5655
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.