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-18T20:06:31Z in 1.203 seconds.

info:
category:
ANY
transactionscount:
39
satcount:
139
above:

25 results

  1. satid:
    2361
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014L
    launchDate:
    1963-05-09
    satlat:
    57.3506
    satlng:
    16.2137
    satalt:
    3485.263
  2. satid:
    2949
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014AS
    launchDate:
    1963-05-09
    satlat:
    64.1717
    satlng:
    15.5159
    satalt:
    4437.6188
  3. satid:
    3825
    satname:
    OV1-19
    intDesignator:
    1969-025C
    launchDate:
    1969-03-18
    satlat:
    70.1065
    satlng:
    6.5705
    satalt:
    5197.0284
  4. satid:
    4383
    satname:
    COSMOS 336
    intDesignator:
    1970-036A
    launchDate:
    1970-04-25
    satlat:
    56.2598
    satlng:
    16.3447
    satalt:
    1494.9751
  5. satid:
    4964
    satname:
    COSMOS 397
    intDesignator:
    1971-015A
    launchDate:
    1971-02-25
    satlat:
    59.1887
    satlng:
    14.0085
    satalt:
    1115.2576
  6. satid:
    6302
    satname:
    SL-6 R/B(2)
    intDesignator:
    1972-072E
    launchDate:
    1972-09-19
    satlat:
    56.5417
    satlng:
    3.1798
    satalt:
    31808.02
  7. satid:
    6747
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1961-015KM
    launchDate:
    1961-06-29
    satlat:
    54.8953
    satlng:
    12.7962
    satalt:
    822.2265
  8. satid:
    7629
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-007D
    launchDate:
    1975-01-30
    satlat:
    54.5988
    satlng:
    44.4608
    satalt:
    33861.84
  9. satid:
    8018
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-063D
    launchDate:
    1975-07-08
    satlat:
    49.8823
    satlng:
    -8.217
    satalt:
    11993.73
  10. satid:
    8292
    satname:
    COSMOS 768
    intDesignator:
    1975-086H
    launchDate:
    1975-09-17
    satlat:
    56.2413
    satlng:
    6.6847
    satalt:
    1483.5532
  11. satid:
    8608
    satname:
    COSMOS 792
    intDesignator:
    1976-008B
    launchDate:
    1976-01-28
    satlat:
    53.0519
    satlng:
    9.299
    satalt:
    1498.529
  12. satid:
    9271
    satname:
    TITAN 34B AGENA R/B
    intDesignator:
    1976-080B
    launchDate:
    1976-08-06
    satlat:
    56.3837
    satlng:
    39.4214
    satalt:
    30143.3929
  13. satid:
    9964
    satname:
    COSMOS 886 DEB
    intDesignator:
    1976-126BE
    launchDate:
    1976-12-27
    satlat:
    63.2406
    satlng:
    3.5874
    satalt:
    1768.2841
  14. satid:
    11079
    satname:
    SL-6 R/B(2)
    intDesignator:
    1978-095E
    launchDate:
    1978-10-13
    satlat:
    58.8211
    satlng:
    -18.8434
    satalt:
    30104.6793
  15. satid:
    12446
    satname:
    TITAN 34B R/B
    intDesignator:
    1981-038B
    launchDate:
    1981-04-24
    satlat:
    63.0131
    satlng:
    -29.7912
    satalt:
    14460.204
  16. satid:
    13507
    satname:
    COSMOS 886 DEB
    intDesignator:
    1976-126BK
    launchDate:
    1976-12-27
    satlat:
    53.983
    satlng:
    15.4639
    satalt:
    2372.7858
  17. satid:
    14191
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-070D
    launchDate:
    1983-07-08
    satlat:
    68.0542
    satlng:
    -19.5599
    satalt:
    32471.8104
  18. satid:
    14608
    satname:
    SL-12 R/B(AUX MOTOR)
    intDesignator:
    1983-127H
    launchDate:
    1983-12-29
    satlat:
    51.2977
    satlng:
    -10.3953
    satalt:
    10239.8155
  19. satid:
    14883
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086GS
    launchDate:
    1973-11-06
    satlat:
    58.7546
    satlng:
    -3.7997
    satalt:
    1890.3006
  20. satid:
    14894
    satname:
    SL-6 R/B(2)
    intDesignator:
    1984-033D
    launchDate:
    1984-04-04
    satlat:
    70.6965
    satlng:
    33.98
    satalt:
    20365.9215
  21. satid:
    15227
    satname:
    TITAN 34B R/B
    intDesignator:
    1984-091B
    launchDate:
    1984-08-28
    satlat:
    62.7259
    satlng:
    2.8603
    satalt:
    37858.1319
  22. satid:
    15266
    satname:
    SL-12 R/B(AUX MOTOR)
    intDesignator:
    1984-095H
    launchDate:
    1984-09-04
    satlat:
    48.5543
    satlng:
    26.8644
    satalt:
    13373.6078
  23. satid:
    15271
    satname:
    NAVSTAR 10 (USA 5)
    intDesignator:
    1984-097A
    launchDate:
    1984-09-08
    satlat:
    57.6804
    satlng:
    15.1958
    satalt:
    21281.7721
  24. satid:
    15272
    satname:
    ATLAS 14E R/B
    intDesignator:
    1984-097B
    launchDate:
    1984-09-08
    satlat:
    54.3566
    satlng:
    -23.7064
    satalt:
    14864.927
  25. satid:
    15429
    satname:
    MOLNIYA 1-63
    intDesignator:
    1984-124A
    launchDate:
    1984-12-14
    satlat:
    42.6722
    satlng:
    30.6788
    satalt:
    27821.6999
limit:
25
offset:
0
returned:
25
has_more_results:
yes
next_offset:
25
Show all fields in HTML
info:
category:
ANY
transactionscount:
39
satcount:
139
above:

25 results

  1. satid:
    2361
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014L
    launchDate:
    1963-05-09
    satlat:
    57.3506
    satlng:
    16.2137
    satalt:
    3485.263
  2. satid:
    2949
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014AS
    launchDate:
    1963-05-09
    satlat:
    64.1717
    satlng:
    15.5159
    satalt:
    4437.6188
  3. satid:
    3825
    satname:
    OV1-19
    intDesignator:
    1969-025C
    launchDate:
    1969-03-18
    satlat:
    70.1065
    satlng:
    6.5705
    satalt:
    5197.0284
  4. satid:
    4383
    satname:
    COSMOS 336
    intDesignator:
    1970-036A
    launchDate:
    1970-04-25
    satlat:
    56.2598
    satlng:
    16.3447
    satalt:
    1494.9751
  5. satid:
    4964
    satname:
    COSMOS 397
    intDesignator:
    1971-015A
    launchDate:
    1971-02-25
    satlat:
    59.1887
    satlng:
    14.0085
    satalt:
    1115.2576
  6. satid:
    6302
    satname:
    SL-6 R/B(2)
    intDesignator:
    1972-072E
    launchDate:
    1972-09-19
    satlat:
    56.5417
    satlng:
    3.1798
    satalt:
    31808.02
  7. satid:
    6747
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1961-015KM
    launchDate:
    1961-06-29
    satlat:
    54.8953
    satlng:
    12.7962
    satalt:
    822.2265
  8. satid:
    7629
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-007D
    launchDate:
    1975-01-30
    satlat:
    54.5988
    satlng:
    44.4608
    satalt:
    33861.84
  9. satid:
    8018
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-063D
    launchDate:
    1975-07-08
    satlat:
    49.8823
    satlng:
    -8.217
    satalt:
    11993.73
  10. satid:
    8292
    satname:
    COSMOS 768
    intDesignator:
    1975-086H
    launchDate:
    1975-09-17
    satlat:
    56.2413
    satlng:
    6.6847
    satalt:
    1483.5532
  11. satid:
    8608
    satname:
    COSMOS 792
    intDesignator:
    1976-008B
    launchDate:
    1976-01-28
    satlat:
    53.0519
    satlng:
    9.299
    satalt:
    1498.529
  12. satid:
    9271
    satname:
    TITAN 34B AGENA R/B
    intDesignator:
    1976-080B
    launchDate:
    1976-08-06
    satlat:
    56.3837
    satlng:
    39.4214
    satalt:
    30143.3929
  13. satid:
    9964
    satname:
    COSMOS 886 DEB
    intDesignator:
    1976-126BE
    launchDate:
    1976-12-27
    satlat:
    63.2406
    satlng:
    3.5874
    satalt:
    1768.2841
  14. satid:
    11079
    satname:
    SL-6 R/B(2)
    intDesignator:
    1978-095E
    launchDate:
    1978-10-13
    satlat:
    58.8211
    satlng:
    -18.8434
    satalt:
    30104.6793
  15. satid:
    12446
    satname:
    TITAN 34B R/B
    intDesignator:
    1981-038B
    launchDate:
    1981-04-24
    satlat:
    63.0131
    satlng:
    -29.7912
    satalt:
    14460.204
  16. satid:
    13507
    satname:
    COSMOS 886 DEB
    intDesignator:
    1976-126BK
    launchDate:
    1976-12-27
    satlat:
    53.983
    satlng:
    15.4639
    satalt:
    2372.7858
  17. satid:
    14191
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-070D
    launchDate:
    1983-07-08
    satlat:
    68.0542
    satlng:
    -19.5599
    satalt:
    32471.8104
  18. satid:
    14608
    satname:
    SL-12 R/B(AUX MOTOR)
    intDesignator:
    1983-127H
    launchDate:
    1983-12-29
    satlat:
    51.2977
    satlng:
    -10.3953
    satalt:
    10239.8155
  19. satid:
    14883
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086GS
    launchDate:
    1973-11-06
    satlat:
    58.7546
    satlng:
    -3.7997
    satalt:
    1890.3006
  20. satid:
    14894
    satname:
    SL-6 R/B(2)
    intDesignator:
    1984-033D
    launchDate:
    1984-04-04
    satlat:
    70.6965
    satlng:
    33.98
    satalt:
    20365.9215
  21. satid:
    15227
    satname:
    TITAN 34B R/B
    intDesignator:
    1984-091B
    launchDate:
    1984-08-28
    satlat:
    62.7259
    satlng:
    2.8603
    satalt:
    37858.1319
  22. satid:
    15266
    satname:
    SL-12 R/B(AUX MOTOR)
    intDesignator:
    1984-095H
    launchDate:
    1984-09-04
    satlat:
    48.5543
    satlng:
    26.8644
    satalt:
    13373.6078
  23. satid:
    15271
    satname:
    NAVSTAR 10 (USA 5)
    intDesignator:
    1984-097A
    launchDate:
    1984-09-08
    satlat:
    57.6804
    satlng:
    15.1958
    satalt:
    21281.7721
  24. satid:
    15272
    satname:
    ATLAS 14E R/B
    intDesignator:
    1984-097B
    launchDate:
    1984-09-08
    satlat:
    54.3566
    satlng:
    -23.7064
    satalt:
    14864.927
  25. satid:
    15429
    satname:
    MOLNIYA 1-63
    intDesignator:
    1984-124A
    launchDate:
    1984-12-14
    satlat:
    42.6722
    satlng:
    30.6788
    satalt:
    27821.6999
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.