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-17T20:06:57Z in 2.165 seconds.

info:
category:
ANY
transactionscount:
22
satcount:
119
above:

25 results

  1. satid:
    649
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1961-015HA
    launchDate:
    1961-06-29
    satlat:
    60.7609
    satlng:
    7.1591
    satalt:
    1370.3961
  2. satid:
    2531
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014AK
    launchDate:
    1963-05-09
    satlat:
    55.0716
    satlng:
    -2.4779
    satalt:
    3660.7418
  3. satid:
    2997
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014AU
    launchDate:
    1963-05-09
    satlat:
    64.4786
    satlng:
    -5.1343
    satalt:
    2523.0658
  4. satid:
    4841
    satname:
    DELTA 1 DEB
    intDesignator:
    1968-055D
    launchDate:
    1968-07-04
    satlat:
    59.3196
    satlng:
    10.0425
    satalt:
    5766.1337
  5. satid:
    6302
    satname:
    SL-6 R/B(2)
    intDesignator:
    1972-072E
    launchDate:
    1972-09-19
    satlat:
    52.0918
    satlng:
    -1.5103
    satalt:
    30423.7242
  6. satid:
    7629
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-007D
    launchDate:
    1975-01-30
    satlat:
    55.4161
    satlng:
    44.2416
    satalt:
    33864.331
  7. satid:
    10713
    satname:
    DELTA 1 DEB
    intDesignator:
    1976-077AJ
    launchDate:
    1976-07-29
    satlat:
    56.3891
    satlng:
    3.182
    satalt:
    1308.1589
  8. satid:
    11876
    satname:
    COSMOS 1193
    intDesignator:
    1980-058B
    launchDate:
    1980-07-09
    satlat:
    63.396
    satlng:
    12.8543
    satalt:
    1425.557
  9. satid:
    12818
    satname:
    COSMOS 1305
    intDesignator:
    1981-088A
    launchDate:
    1981-09-11
    satlat:
    62.7965
    satlng:
    43.2846
    satalt:
    13823.2364
  10. satid:
    13767
    satname:
    COSMOS 1435
    intDesignator:
    1983-002G
    launchDate:
    1983-01-19
    satlat:
    58.8708
    satlng:
    0.0855
    satalt:
    1453.4355
  11. satid:
    14131
    satname:
    SL-6 DEB
    intDesignator:
    1981-088M
    launchDate:
    1981-09-11
    satlat:
    63.086
    satlng:
    8.1189
    satalt:
    4490.6936
  12. satid:
    14139
    satname:
    OPS 3899
    intDesignator:
    1983-060C
    launchDate:
    1983-06-20
    satlat:
    59.7665
    satlng:
    -0.5527
    satalt:
    1294.5252
  13. satid:
    14191
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-070D
    launchDate:
    1983-07-08
    satlat:
    65.7102
    satlng:
    -28.245
    satalt:
    33387.2115
  14. satid:
    14608
    satname:
    SL-12 R/B(AUX MOTOR)
    intDesignator:
    1983-127H
    launchDate:
    1983-12-29
    satlat:
    51.575
    satlng:
    4.9906
    satalt:
    11872.8222
  15. satid:
    14883
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086GS
    launchDate:
    1973-11-06
    satlat:
    56.8792
    satlng:
    -5.3245
    satalt:
    1889.8315
  16. satid:
    14894
    satname:
    SL-6 R/B(2)
    intDesignator:
    1984-033D
    launchDate:
    1984-04-04
    satlat:
    68.0618
    satlng:
    8.9851
    satalt:
    23663.5622
  17. satid:
    15227
    satname:
    TITAN 34B R/B
    intDesignator:
    1984-091B
    launchDate:
    1984-08-28
    satlat:
    63.1105
    satlng:
    -11.0305
    satalt:
    37923.2797
  18. satid:
    15272
    satname:
    ATLAS 14E R/B
    intDesignator:
    1984-097B
    launchDate:
    1984-09-08
    satlat:
    63.5434
    satlng:
    6.4706
    satalt:
    17936.6716
  19. satid:
    15429
    satname:
    MOLNIYA 1-63
    intDesignator:
    1984-124A
    launchDate:
    1984-12-14
    satlat:
    41.9528
    satlng:
    30.9437
    satalt:
    27292.572
  20. satid:
    15741
    satname:
    SL-6 R/B(2)
    intDesignator:
    1985-040D
    launchDate:
    1985-05-29
    satlat:
    61.5086
    satlng:
    19.8378
    satalt:
    39976.7199
  21. satid:
    16393
    satname:
    MOLNIYA 3-27
    intDesignator:
    1985-117A
    launchDate:
    1985-12-24
    satlat:
    61.4591
    satlng:
    -20.2418
    satalt:
    30737.6961
  22. satid:
    16527
    satname:
    COSMOS 1729
    intDesignator:
    1986-011A
    launchDate:
    1986-02-01
    satlat:
    54.5029
    satlng:
    7.7956
    satalt:
    13603.0491
  23. satid:
    17018
    satname:
    COSMOS 839 DEB
    intDesignator:
    1976-067BJ
    launchDate:
    1976-07-08
    satlat:
    60.469
    satlng:
    0.4742
    satalt:
    1361.6703
  24. satid:
    18562
    satname:
    SCOUT G-1 DEB
    intDesignator:
    1987-080H
    launchDate:
    1987-09-16
    satlat:
    60.5077
    satlng:
    4.7908
    satalt:
    1026.2067
  25. satid:
    18949
    satname:
    SL-6 R/B(2)
    intDesignator:
    1988-017D
    launchDate:
    1988-03-11
    satlat:
    42.5658
    satlng:
    0.9755
    satalt:
    17853.9162
limit:
25
offset:
0
returned:
25
has_more_results:
yes
next_offset:
25
Show all fields in HTML
info:
category:
ANY
transactionscount:
22
satcount:
119
above:

25 results

  1. satid:
    649
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1961-015HA
    launchDate:
    1961-06-29
    satlat:
    60.7609
    satlng:
    7.1591
    satalt:
    1370.3961
  2. satid:
    2531
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014AK
    launchDate:
    1963-05-09
    satlat:
    55.0716
    satlng:
    -2.4779
    satalt:
    3660.7418
  3. satid:
    2997
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014AU
    launchDate:
    1963-05-09
    satlat:
    64.4786
    satlng:
    -5.1343
    satalt:
    2523.0658
  4. satid:
    4841
    satname:
    DELTA 1 DEB
    intDesignator:
    1968-055D
    launchDate:
    1968-07-04
    satlat:
    59.3196
    satlng:
    10.0425
    satalt:
    5766.1337
  5. satid:
    6302
    satname:
    SL-6 R/B(2)
    intDesignator:
    1972-072E
    launchDate:
    1972-09-19
    satlat:
    52.0918
    satlng:
    -1.5103
    satalt:
    30423.7242
  6. satid:
    7629
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-007D
    launchDate:
    1975-01-30
    satlat:
    55.4161
    satlng:
    44.2416
    satalt:
    33864.331
  7. satid:
    10713
    satname:
    DELTA 1 DEB
    intDesignator:
    1976-077AJ
    launchDate:
    1976-07-29
    satlat:
    56.3891
    satlng:
    3.182
    satalt:
    1308.1589
  8. satid:
    11876
    satname:
    COSMOS 1193
    intDesignator:
    1980-058B
    launchDate:
    1980-07-09
    satlat:
    63.396
    satlng:
    12.8543
    satalt:
    1425.557
  9. satid:
    12818
    satname:
    COSMOS 1305
    intDesignator:
    1981-088A
    launchDate:
    1981-09-11
    satlat:
    62.7965
    satlng:
    43.2846
    satalt:
    13823.2364
  10. satid:
    13767
    satname:
    COSMOS 1435
    intDesignator:
    1983-002G
    launchDate:
    1983-01-19
    satlat:
    58.8708
    satlng:
    0.0855
    satalt:
    1453.4355
  11. satid:
    14131
    satname:
    SL-6 DEB
    intDesignator:
    1981-088M
    launchDate:
    1981-09-11
    satlat:
    63.086
    satlng:
    8.1189
    satalt:
    4490.6936
  12. satid:
    14139
    satname:
    OPS 3899
    intDesignator:
    1983-060C
    launchDate:
    1983-06-20
    satlat:
    59.7665
    satlng:
    -0.5527
    satalt:
    1294.5252
  13. satid:
    14191
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-070D
    launchDate:
    1983-07-08
    satlat:
    65.7102
    satlng:
    -28.245
    satalt:
    33387.2115
  14. satid:
    14608
    satname:
    SL-12 R/B(AUX MOTOR)
    intDesignator:
    1983-127H
    launchDate:
    1983-12-29
    satlat:
    51.575
    satlng:
    4.9906
    satalt:
    11872.8222
  15. satid:
    14883
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086GS
    launchDate:
    1973-11-06
    satlat:
    56.8792
    satlng:
    -5.3245
    satalt:
    1889.8315
  16. satid:
    14894
    satname:
    SL-6 R/B(2)
    intDesignator:
    1984-033D
    launchDate:
    1984-04-04
    satlat:
    68.0618
    satlng:
    8.9851
    satalt:
    23663.5622
  17. satid:
    15227
    satname:
    TITAN 34B R/B
    intDesignator:
    1984-091B
    launchDate:
    1984-08-28
    satlat:
    63.1105
    satlng:
    -11.0305
    satalt:
    37923.2797
  18. satid:
    15272
    satname:
    ATLAS 14E R/B
    intDesignator:
    1984-097B
    launchDate:
    1984-09-08
    satlat:
    63.5434
    satlng:
    6.4706
    satalt:
    17936.6716
  19. satid:
    15429
    satname:
    MOLNIYA 1-63
    intDesignator:
    1984-124A
    launchDate:
    1984-12-14
    satlat:
    41.9528
    satlng:
    30.9437
    satalt:
    27292.572
  20. satid:
    15741
    satname:
    SL-6 R/B(2)
    intDesignator:
    1985-040D
    launchDate:
    1985-05-29
    satlat:
    61.5086
    satlng:
    19.8378
    satalt:
    39976.7199
  21. satid:
    16393
    satname:
    MOLNIYA 3-27
    intDesignator:
    1985-117A
    launchDate:
    1985-12-24
    satlat:
    61.4591
    satlng:
    -20.2418
    satalt:
    30737.6961
  22. satid:
    16527
    satname:
    COSMOS 1729
    intDesignator:
    1986-011A
    launchDate:
    1986-02-01
    satlat:
    54.5029
    satlng:
    7.7956
    satalt:
    13603.0491
  23. satid:
    17018
    satname:
    COSMOS 839 DEB
    intDesignator:
    1976-067BJ
    launchDate:
    1976-07-08
    satlat:
    60.469
    satlng:
    0.4742
    satalt:
    1361.6703
  24. satid:
    18562
    satname:
    SCOUT G-1 DEB
    intDesignator:
    1987-080H
    launchDate:
    1987-09-16
    satlat:
    60.5077
    satlng:
    4.7908
    satalt:
    1026.2067
  25. satid:
    18949
    satname:
    SL-6 R/B(2)
    intDesignator:
    1988-017D
    launchDate:
    1988-03-11
    satlat:
    42.5658
    satlng:
    0.9755
    satalt:
    17853.9162
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.