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-22T23:12:40Z in 1.094 seconds.

info:
category:
ANY
transactionscount:
100
satcount:
109
above:

25 results

  1. satid:
    629
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014G
    launchDate:
    1963-05-09
    satlat:
    70.986
    satlng:
    4.581
    satalt:
    3666.5886
  2. satid:
    702
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014H
    launchDate:
    1963-05-09
    satlat:
    73.3445
    satlng:
    1.9009
    satalt:
    3718.9063
  3. satid:
    2361
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014L
    launchDate:
    1963-05-09
    satlat:
    73.9396
    satlng:
    -7.4318
    satalt:
    3534.7832
  4. satid:
    3510
    satname:
    OPS 4078 (DMSP 4B F2)
    intDesignator:
    1968-092A
    launchDate:
    1968-10-23
    satlat:
    71.0126
    satlng:
    10.9585
    satalt:
    790.8029
  5. satid:
    3752
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1961-015JE
    launchDate:
    1961-06-29
    satlat:
    66.63
    satlng:
    15.7259
    satalt:
    1014.4079
  6. satid:
    3892
    satname:
    THORAD AGENA D R/B
    intDesignator:
    1969-037C
    launchDate:
    1969-04-14
    satlat:
    66.2901
    satlng:
    26.1076
    satalt:
    1105.3374
  7. satid:
    4677
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025BA
    launchDate:
    1970-04-08
    satlat:
    70.1682
    satlng:
    8.9043
    satalt:
    1059.3498
  8. satid:
    5054
    satname:
    TITAN 34B AGENA D R/B
    intDesignator:
    1971-021B
    launchDate:
    1971-03-21
    satlat:
    55.2978
    satlng:
    50.674
    satalt:
    30290.7266
  9. satid:
    6302
    satname:
    SL-6 R/B(2)
    intDesignator:
    1972-072E
    launchDate:
    1972-09-19
    satlat:
    67.1848
    satlng:
    69.2377
    satalt:
    31490.1009
  10. satid:
    6826
    satname:
    SL-8 R/B
    intDesignator:
    1973-064B
    launchDate:
    1973-09-08
    satlat:
    69.1962
    satlng:
    6.4799
    satalt:
    1415.2698
  11. satid:
    7146
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086DL
    launchDate:
    1973-11-06
    satlat:
    73.8414
    satlng:
    16.3718
    satalt:
    1523.0613
  12. satid:
    7284
    satname:
    SL-8 R/B
    intDesignator:
    1974-028B
    launchDate:
    1974-04-29
    satlat:
    70.4231
    satlng:
    22.8328
    satalt:
    1382.744
  13. satid:
    7373
    satname:
    SL-6 R/B(2)
    intDesignator:
    1974-026E
    launchDate:
    1974-04-26
    satlat:
    63.9638
    satlng:
    26.0695
    satalt:
    37771.4535
  14. satid:
    7376
    satname:
    MOLNIYA 2-10
    intDesignator:
    1974-056A
    launchDate:
    1974-07-23
    satlat:
    58.5543
    satlng:
    71.7722
    satalt:
    32101.249
  15. satid:
    7629
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-007D
    launchDate:
    1975-01-30
    satlat:
    50.0978
    satlng:
    29.9539
    satalt:
    33706.0833
  16. satid:
    8709
    satname:
    UME 1 (ISS 1)
    intDesignator:
    1976-019A
    launchDate:
    1976-02-29
    satlat:
    68.6346
    satlng:
    12.7808
    satalt:
    1007.0522
  17. satid:
    9271
    satname:
    TITAN 34B AGENA R/B
    intDesignator:
    1976-080B
    launchDate:
    1976-08-06
    satlat:
    56.4817
    satlng:
    22.5916
    satalt:
    30207.0722
  18. satid:
    9652
    satname:
    COSMOS 886 DEB
    intDesignator:
    1976-126J
    launchDate:
    1976-12-27
    satlat:
    64.0977
    satlng:
    21.1112
    satalt:
    1951.5016
  19. satid:
    10287
    satname:
    COSMOS 941
    intDesignator:
    1977-079C
    launchDate:
    1977-08-24
    satlat:
    72.1633
    satlng:
    28.6751
    satalt:
    1454.4576
  20. satid:
    11079
    satname:
    SL-6 R/B(2)
    intDesignator:
    1978-095E
    launchDate:
    1978-10-13
    satlat:
    63.8798
    satlng:
    -4.6411
    satalt:
    35123.9755
  21. satid:
    12088
    satname:
    SL-8 R/B
    intDesignator:
    1980-097B
    launchDate:
    1980-12-05
    satlat:
    71.1419
    satlng:
    17.1191
    satalt:
    1003.0568
  22. satid:
    12977
    satname:
    COSMOS 1322
    intDesignator:
    1981-116C
    launchDate:
    1981-11-28
    satlat:
    73.6063
    satlng:
    21.6267
    satalt:
    1495.388
  23. satid:
    12997
    satname:
    RADIO 3
    intDesignator:
    1981-120A
    launchDate:
    1981-12-17
    satlat:
    70.9459
    satlng:
    19.1716
    satalt:
    1590.0734
  24. satid:
    14172
    satname:
    COSMOS 1474
    intDesignator:
    1983-069B
    launchDate:
    1983-07-06
    satlat:
    73.6141
    satlng:
    25.8208
    satalt:
    1462.8029
  25. satid:
    14190
    satname:
    ATLAS 75E R/B
    intDesignator:
    1983-072B
    launchDate:
    1983-07-14
    satlat:
    64.1274
    satlng:
    10.11
    satalt:
    9457.7838
limit:
25
offset:
0
returned:
25
has_more_results:
yes
truncated:
yes
next_offset:
25
Show all fields in HTML
info:
category:
ANY
transactionscount:
100
satcount:
109
above:

25 results

  1. satid:
    629
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014G
    launchDate:
    1963-05-09
    satlat:
    70.986
    satlng:
    4.581
    satalt:
    3666.5886
  2. satid:
    702
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014H
    launchDate:
    1963-05-09
    satlat:
    73.3445
    satlng:
    1.9009
    satalt:
    3718.9063
  3. satid:
    2361
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014L
    launchDate:
    1963-05-09
    satlat:
    73.9396
    satlng:
    -7.4318
    satalt:
    3534.7832
  4. satid:
    3510
    satname:
    OPS 4078 (DMSP 4B F2)
    intDesignator:
    1968-092A
    launchDate:
    1968-10-23
    satlat:
    71.0126
    satlng:
    10.9585
    satalt:
    790.8029
  5. satid:
    3752
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1961-015JE
    launchDate:
    1961-06-29
    satlat:
    66.63
    satlng:
    15.7259
    satalt:
    1014.4079
  6. satid:
    3892
    satname:
    THORAD AGENA D R/B
    intDesignator:
    1969-037C
    launchDate:
    1969-04-14
    satlat:
    66.2901
    satlng:
    26.1076
    satalt:
    1105.3374
  7. satid:
    4677
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025BA
    launchDate:
    1970-04-08
    satlat:
    70.1682
    satlng:
    8.9043
    satalt:
    1059.3498
  8. satid:
    5054
    satname:
    TITAN 34B AGENA D R/B
    intDesignator:
    1971-021B
    launchDate:
    1971-03-21
    satlat:
    55.2978
    satlng:
    50.674
    satalt:
    30290.7266
  9. satid:
    6302
    satname:
    SL-6 R/B(2)
    intDesignator:
    1972-072E
    launchDate:
    1972-09-19
    satlat:
    67.1848
    satlng:
    69.2377
    satalt:
    31490.1009
  10. satid:
    6826
    satname:
    SL-8 R/B
    intDesignator:
    1973-064B
    launchDate:
    1973-09-08
    satlat:
    69.1962
    satlng:
    6.4799
    satalt:
    1415.2698
  11. satid:
    7146
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086DL
    launchDate:
    1973-11-06
    satlat:
    73.8414
    satlng:
    16.3718
    satalt:
    1523.0613
  12. satid:
    7284
    satname:
    SL-8 R/B
    intDesignator:
    1974-028B
    launchDate:
    1974-04-29
    satlat:
    70.4231
    satlng:
    22.8328
    satalt:
    1382.744
  13. satid:
    7373
    satname:
    SL-6 R/B(2)
    intDesignator:
    1974-026E
    launchDate:
    1974-04-26
    satlat:
    63.9638
    satlng:
    26.0695
    satalt:
    37771.4535
  14. satid:
    7376
    satname:
    MOLNIYA 2-10
    intDesignator:
    1974-056A
    launchDate:
    1974-07-23
    satlat:
    58.5543
    satlng:
    71.7722
    satalt:
    32101.249
  15. satid:
    7629
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-007D
    launchDate:
    1975-01-30
    satlat:
    50.0978
    satlng:
    29.9539
    satalt:
    33706.0833
  16. satid:
    8709
    satname:
    UME 1 (ISS 1)
    intDesignator:
    1976-019A
    launchDate:
    1976-02-29
    satlat:
    68.6346
    satlng:
    12.7808
    satalt:
    1007.0522
  17. satid:
    9271
    satname:
    TITAN 34B AGENA R/B
    intDesignator:
    1976-080B
    launchDate:
    1976-08-06
    satlat:
    56.4817
    satlng:
    22.5916
    satalt:
    30207.0722
  18. satid:
    9652
    satname:
    COSMOS 886 DEB
    intDesignator:
    1976-126J
    launchDate:
    1976-12-27
    satlat:
    64.0977
    satlng:
    21.1112
    satalt:
    1951.5016
  19. satid:
    10287
    satname:
    COSMOS 941
    intDesignator:
    1977-079C
    launchDate:
    1977-08-24
    satlat:
    72.1633
    satlng:
    28.6751
    satalt:
    1454.4576
  20. satid:
    11079
    satname:
    SL-6 R/B(2)
    intDesignator:
    1978-095E
    launchDate:
    1978-10-13
    satlat:
    63.8798
    satlng:
    -4.6411
    satalt:
    35123.9755
  21. satid:
    12088
    satname:
    SL-8 R/B
    intDesignator:
    1980-097B
    launchDate:
    1980-12-05
    satlat:
    71.1419
    satlng:
    17.1191
    satalt:
    1003.0568
  22. satid:
    12977
    satname:
    COSMOS 1322
    intDesignator:
    1981-116C
    launchDate:
    1981-11-28
    satlat:
    73.6063
    satlng:
    21.6267
    satalt:
    1495.388
  23. satid:
    12997
    satname:
    RADIO 3
    intDesignator:
    1981-120A
    launchDate:
    1981-12-17
    satlat:
    70.9459
    satlng:
    19.1716
    satalt:
    1590.0734
  24. satid:
    14172
    satname:
    COSMOS 1474
    intDesignator:
    1983-069B
    launchDate:
    1983-07-06
    satlat:
    73.6141
    satlng:
    25.8208
    satalt:
    1462.8029
  25. satid:
    14190
    satname:
    ATLAS 75E R/B
    intDesignator:
    1983-072B
    launchDate:
    1983-07-14
    satlat:
    64.1274
    satlng:
    10.11
    satalt:
    9457.7838
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.