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-22T04:00:41Z in 0.880 seconds.

info:
category:
ANY
transactionscount:
9
satcount:
123
above:

25 results

  1. satid:
    692
    satname:
    VELA 1
    intDesignator:
    1963-039C
    launchDate:
    1963-10-17
    satlat:
    32.3095
    satlng:
    22.7907
    satalt:
    155571.76
  2. satid:
    2365
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014Q
    launchDate:
    1963-05-09
    satlat:
    62.3469
    satlng:
    0.3281
    satalt:
    3452.9592
  3. satid:
    2765
    satname:
    OPS 6638 (VELA 7)
    intDesignator:
    1967-040A
    launchDate:
    1967-04-28
    satlat:
    38.9953
    satlng:
    27.3423
    satalt:
    166274.9099
  4. satid:
    3051
    satname:
    DELTA 1 DEB
    intDesignator:
    1967-114C
    launchDate:
    1967-11-10
    satlat:
    58.1766
    satlng:
    10.4987
    satalt:
    1438.4548
  5. satid:
    4617
    satname:
    COSMOS 374 DEB
    intDesignator:
    1970-089D
    launchDate:
    1970-10-23
    satlat:
    57.6047
    satlng:
    12.5116
    satalt:
    866.8747
  6. satid:
    4982
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025HC
    launchDate:
    1970-04-08
    satlat:
    55.5188
    satlng:
    14.3979
    satalt:
    1167.5701
  7. satid:
    5054
    satname:
    TITAN 34B AGENA D R/B
    intDesignator:
    1971-021B
    launchDate:
    1971-03-21
    satlat:
    62.6011
    satlng:
    4.8165
    satalt:
    35155.524
  8. satid:
    5098
    satname:
    COSMOS 397 DEB
    intDesignator:
    1971-015X
    launchDate:
    1971-02-25
    satlat:
    62.3625
    satlng:
    0.7721
    satalt:
    1594.941
  9. satid:
    6197
    satname:
    EXPLORER 47 (IMP-7)
    intDesignator:
    1972-073A
    launchDate:
    1972-09-23
    satlat:
    58.1166
    satlng:
    21.7143
    satalt:
    274940.3019
  10. satid:
    7094
    satname:
    COSMOS 628
    intDesignator:
    1974-001A
    launchDate:
    1974-01-17
    satlat:
    61.7818
    satlng:
    10.121
    satalt:
    985.1411
  11. satid:
    7276
    satname:
    MOLNIYA 2-9
    intDesignator:
    1974-026A
    launchDate:
    1974-04-26
    satlat:
    63.8336
    satlng:
    11.1376
    satalt:
    30251.5795
  12. satid:
    7688
    satname:
    TITAN 34B R/B
    intDesignator:
    1975-017B
    launchDate:
    1975-03-10
    satlat:
    49.2169
    satlng:
    31.4674
    satalt:
    11273.8236
  13. satid:
    9011
    satname:
    COSMOS 839
    intDesignator:
    1976-067A
    launchDate:
    1976-07-08
    satlat:
    65.0679
    satlng:
    1.1948
    satalt:
    2052.422
  14. satid:
    9880
    satname:
    MOLNIYA 1-36
    intDesignator:
    1977-021A
    launchDate:
    1977-03-24
    satlat:
    56.3144
    satlng:
    54.0992
    satalt:
    27183.8321
  15. satid:
    11141
    satname:
    OPS 5114 (NAVSTAR 4)
    intDesignator:
    1978-112A
    launchDate:
    1978-12-11
    satlat:
    56.0669
    satlng:
    24.6064
    satalt:
    20506.6758
  16. satid:
    12078
    satname:
    COSMOS 1223
    intDesignator:
    1980-095A
    launchDate:
    1980-11-27
    satlat:
    60.6256
    satlng:
    -17.6734
    satalt:
    22660.9727
  17. satid:
    13080
    satname:
    COSMOS 1341
    intDesignator:
    1982-016A
    launchDate:
    1982-03-03
    satlat:
    70.3519
    satlng:
    -31.4189
    satalt:
    25127.4999
  18. satid:
    14259
    satname:
    COSMOS 1491 (GLONASS)
    intDesignator:
    1983-084B
    launchDate:
    1983-08-10
    satlat:
    51.9608
    satlng:
    -0.8764
    satalt:
    18976.2442
  19. satid:
    14884
    satname:
    COSMOS 1547
    intDesignator:
    1984-033A
    launchDate:
    1984-04-04
    satlat:
    67.6658
    satlng:
    4.2083
    satalt:
    25082.4495
  20. satid:
    15429
    satname:
    MOLNIYA 1-63
    intDesignator:
    1984-124A
    launchDate:
    1984-12-14
    satlat:
    44.3913
    satlng:
    30.2498
    satalt:
    17258.6284
  21. satid:
    15936
    satname:
    OSCAR 24
    intDesignator:
    1985-066B
    launchDate:
    1985-08-03
    satlat:
    62.328
    satlng:
    6.4799
    satalt:
    1224.4808
  22. satid:
    16402
    satname:
    SL-6 R/B(2)
    intDesignator:
    1985-117F
    launchDate:
    1985-12-24
    satlat:
    62.4581
    satlng:
    -1.2387
    satalt:
    38751.9333
  23. satid:
    16404
    satname:
    SL-12 R/B(2)
    intDesignator:
    1985-118F
    launchDate:
    1985-12-24
    satlat:
    64.9128
    satlng:
    -23.0685
    satalt:
    19135.5599
  24. satid:
    16961
    satname:
    COSMOS 1778 (GLONASS)
    intDesignator:
    1986-071A
    launchDate:
    1986-09-16
    satlat:
    60.2314
    satlng:
    31.7895
    satalt:
    19148.5116
  25. satid:
    17147
    satname:
    SL-6 R/B(2)
    intDesignator:
    1986-091D
    launchDate:
    1986-11-20
    satlat:
    71.5111
    satlng:
    40.3447
    satalt:
    20444.6672
limit:
25
offset:
0
returned:
25
has_more_results:
yes
next_offset:
25
Show all fields in HTML
info:
category:
ANY
transactionscount:
9
satcount:
123
above:

25 results

  1. satid:
    692
    satname:
    VELA 1
    intDesignator:
    1963-039C
    launchDate:
    1963-10-17
    satlat:
    32.3095
    satlng:
    22.7907
    satalt:
    155571.76
  2. satid:
    2365
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014Q
    launchDate:
    1963-05-09
    satlat:
    62.3469
    satlng:
    0.3281
    satalt:
    3452.9592
  3. satid:
    2765
    satname:
    OPS 6638 (VELA 7)
    intDesignator:
    1967-040A
    launchDate:
    1967-04-28
    satlat:
    38.9953
    satlng:
    27.3423
    satalt:
    166274.9099
  4. satid:
    3051
    satname:
    DELTA 1 DEB
    intDesignator:
    1967-114C
    launchDate:
    1967-11-10
    satlat:
    58.1766
    satlng:
    10.4987
    satalt:
    1438.4548
  5. satid:
    4617
    satname:
    COSMOS 374 DEB
    intDesignator:
    1970-089D
    launchDate:
    1970-10-23
    satlat:
    57.6047
    satlng:
    12.5116
    satalt:
    866.8747
  6. satid:
    4982
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025HC
    launchDate:
    1970-04-08
    satlat:
    55.5188
    satlng:
    14.3979
    satalt:
    1167.5701
  7. satid:
    5054
    satname:
    TITAN 34B AGENA D R/B
    intDesignator:
    1971-021B
    launchDate:
    1971-03-21
    satlat:
    62.6011
    satlng:
    4.8165
    satalt:
    35155.524
  8. satid:
    5098
    satname:
    COSMOS 397 DEB
    intDesignator:
    1971-015X
    launchDate:
    1971-02-25
    satlat:
    62.3625
    satlng:
    0.7721
    satalt:
    1594.941
  9. satid:
    6197
    satname:
    EXPLORER 47 (IMP-7)
    intDesignator:
    1972-073A
    launchDate:
    1972-09-23
    satlat:
    58.1166
    satlng:
    21.7143
    satalt:
    274940.3019
  10. satid:
    7094
    satname:
    COSMOS 628
    intDesignator:
    1974-001A
    launchDate:
    1974-01-17
    satlat:
    61.7818
    satlng:
    10.121
    satalt:
    985.1411
  11. satid:
    7276
    satname:
    MOLNIYA 2-9
    intDesignator:
    1974-026A
    launchDate:
    1974-04-26
    satlat:
    63.8336
    satlng:
    11.1376
    satalt:
    30251.5795
  12. satid:
    7688
    satname:
    TITAN 34B R/B
    intDesignator:
    1975-017B
    launchDate:
    1975-03-10
    satlat:
    49.2169
    satlng:
    31.4674
    satalt:
    11273.8236
  13. satid:
    9011
    satname:
    COSMOS 839
    intDesignator:
    1976-067A
    launchDate:
    1976-07-08
    satlat:
    65.0679
    satlng:
    1.1948
    satalt:
    2052.422
  14. satid:
    9880
    satname:
    MOLNIYA 1-36
    intDesignator:
    1977-021A
    launchDate:
    1977-03-24
    satlat:
    56.3144
    satlng:
    54.0992
    satalt:
    27183.8321
  15. satid:
    11141
    satname:
    OPS 5114 (NAVSTAR 4)
    intDesignator:
    1978-112A
    launchDate:
    1978-12-11
    satlat:
    56.0669
    satlng:
    24.6064
    satalt:
    20506.6758
  16. satid:
    12078
    satname:
    COSMOS 1223
    intDesignator:
    1980-095A
    launchDate:
    1980-11-27
    satlat:
    60.6256
    satlng:
    -17.6734
    satalt:
    22660.9727
  17. satid:
    13080
    satname:
    COSMOS 1341
    intDesignator:
    1982-016A
    launchDate:
    1982-03-03
    satlat:
    70.3519
    satlng:
    -31.4189
    satalt:
    25127.4999
  18. satid:
    14259
    satname:
    COSMOS 1491 (GLONASS)
    intDesignator:
    1983-084B
    launchDate:
    1983-08-10
    satlat:
    51.9608
    satlng:
    -0.8764
    satalt:
    18976.2442
  19. satid:
    14884
    satname:
    COSMOS 1547
    intDesignator:
    1984-033A
    launchDate:
    1984-04-04
    satlat:
    67.6658
    satlng:
    4.2083
    satalt:
    25082.4495
  20. satid:
    15429
    satname:
    MOLNIYA 1-63
    intDesignator:
    1984-124A
    launchDate:
    1984-12-14
    satlat:
    44.3913
    satlng:
    30.2498
    satalt:
    17258.6284
  21. satid:
    15936
    satname:
    OSCAR 24
    intDesignator:
    1985-066B
    launchDate:
    1985-08-03
    satlat:
    62.328
    satlng:
    6.4799
    satalt:
    1224.4808
  22. satid:
    16402
    satname:
    SL-6 R/B(2)
    intDesignator:
    1985-117F
    launchDate:
    1985-12-24
    satlat:
    62.4581
    satlng:
    -1.2387
    satalt:
    38751.9333
  23. satid:
    16404
    satname:
    SL-12 R/B(2)
    intDesignator:
    1985-118F
    launchDate:
    1985-12-24
    satlat:
    64.9128
    satlng:
    -23.0685
    satalt:
    19135.5599
  24. satid:
    16961
    satname:
    COSMOS 1778 (GLONASS)
    intDesignator:
    1986-071A
    launchDate:
    1986-09-16
    satlat:
    60.2314
    satlng:
    31.7895
    satalt:
    19148.5116
  25. satid:
    17147
    satname:
    SL-6 R/B(2)
    intDesignator:
    1986-091D
    launchDate:
    1986-11-20
    satlat:
    71.5111
    satlng:
    40.3447
    satalt:
    20444.6672
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.