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-11-21T04:26:40Z in 0.748 seconds.

info:
category:
ANY
transactionscount:
77
satcount:
130
above:

25 results

  1. satid:
    2377
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014X
    launchDate:
    1963-05-09
    satlat:
    59.8697
    satlng:
    26.8851
    satalt:
    3285.2995
  2. satid:
    2531
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014AK
    launchDate:
    1963-05-09
    satlat:
    55.4022
    satlng:
    23.1655
    satalt:
    3657.2054
  3. satid:
    2757
    satname:
    ESSA 5
    intDesignator:
    1967-036A
    launchDate:
    1967-04-20
    satlat:
    60.3419
    satlng:
    5.0898
    satalt:
    1413.5361
  4. satid:
    5054
    satname:
    TITAN 34B AGENA D R/B
    intDesignator:
    1971-021B
    launchDate:
    1971-03-21
    satlat:
    53.3987
    satlng:
    -4.9946
    satalt:
    25974.2116
  5. satid:
    5785
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1961-015JZ
    launchDate:
    1961-06-29
    satlat:
    58.3097
    satlng:
    2.7053
    satalt:
    1047.6062
  6. satid:
    7142
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086DG
    launchDate:
    1973-11-06
    satlat:
    61.5314
    satlng:
    5.0127
    satalt:
    1517.5781
  7. satid:
    7532
    satname:
    THORAD DELTA 1 R/B
    intDesignator:
    1974-089D
    launchDate:
    1974-11-15
    satlat:
    59.4824
    satlng:
    -4.6285
    satalt:
    1556.6296
  8. satid:
    7681
    satname:
    COSMOS 714
    intDesignator:
    1975-016D
    launchDate:
    1975-02-28
    satlat:
    61.1792
    satlng:
    11.9793
    satalt:
    1498.655
  9. satid:
    7688
    satname:
    TITAN 34B R/B
    intDesignator:
    1975-017B
    launchDate:
    1975-03-10
    satlat:
    62.752
    satlng:
    45.9198
    satalt:
    14999.2239
  10. satid:
    8195
    satname:
    MOLNIYA 2-14
    intDesignator:
    1975-081A
    launchDate:
    1975-09-09
    satlat:
    47.0784
    satlng:
    39.0795
    satalt:
    30716.2563
  11. satid:
    8612
    satname:
    COSMOS 796
    intDesignator:
    1976-008F
    launchDate:
    1976-01-28
    satlat:
    56.407
    satlng:
    5.9722
    satalt:
    1498.9011
  12. satid:
    9016
    satname:
    SL-8 DEB
    intDesignator:
    1976-067C
    launchDate:
    1976-07-08
    satlat:
    61.4413
    satlng:
    -0.357
    satalt:
    1509.6039
  13. satid:
    9880
    satname:
    MOLNIYA 1-36
    intDesignator:
    1977-021A
    launchDate:
    1977-03-24
    satlat:
    63.7931
    satlng:
    54.6227
    satalt:
    36444.5527
  14. satid:
    9895
    satname:
    COSMOS 862 DEB
    intDesignator:
    1976-105M
    launchDate:
    1976-10-22
    satlat:
    53.1378
    satlng:
    24.8772
    satalt:
    20149.4996
  15. satid:
    10439
    satname:
    COSMOS 839 DEB
    intDesignator:
    1976-067Q
    launchDate:
    1976-07-08
    satlat:
    58.2726
    satlng:
    16.0389
    satalt:
    1600.6467
  16. satid:
    10449
    satname:
    COSMOS 839 DEB
    intDesignator:
    1976-067AA
    launchDate:
    1976-07-08
    satlat:
    65.391
    satlng:
    11.3831
    satalt:
    2091.2163
  17. satid:
    12078
    satname:
    COSMOS 1223
    intDesignator:
    1980-095A
    launchDate:
    1980-11-27
    satlat:
    64.962
    satlng:
    54.4996
    satalt:
    32304.4924
  18. satid:
    12311
    satname:
    SL-6 R/B(2)
    intDesignator:
    1981-016E
    launchDate:
    1981-02-19
    satlat:
    71.8373
    satlng:
    -14.5005
    satalt:
    25857.6869
  19. satid:
    12330
    satname:
    KYOKKO 1 DEB
    intDesignator:
    1978-014D
    launchDate:
    1978-02-04
    satlat:
    60.4516
    satlng:
    -10.9144
    satalt:
    3314.411
  20. satid:
    12889
    satname:
    THOR DELTA 1 R/B
    intDesignator:
    1981-100C
    launchDate:
    1981-10-06
    satlat:
    60.7941
    satlng:
    18.8086
    satalt:
    1725.1898
  21. satid:
    13080
    satname:
    COSMOS 1341
    intDesignator:
    1982-016A
    launchDate:
    1982-03-03
    satlat:
    56.6468
    satlng:
    16.827
    satalt:
    35243.9265
  22. satid:
    13776
    satname:
    COSMOS 397 DEB
    intDesignator:
    1971-015CN
    launchDate:
    1971-02-25
    satlat:
    59.4952
    satlng:
    10.2709
    satalt:
    923.7851
  23. satid:
    13911
    satname:
    SL-6 DEB
    intDesignator:
    1981-088L
    launchDate:
    1981-09-11
    satlat:
    55.5656
    satlng:
    3.2883
    satalt:
    11120.0895
  24. satid:
    14000
    satname:
    COSMOS 931 DEB
    intDesignator:
    1977-068G
    launchDate:
    1977-07-20
    satlat:
    57.673
    satlng:
    19.1245
    satalt:
    15638.1847
  25. satid:
    15095
    satname:
    COSMOS 1581
    intDesignator:
    1984-071A
    launchDate:
    1984-07-03
    satlat:
    49.5365
    satlng:
    28.6184
    satalt:
    18389.9627
Show all fields in HTML
info:
category:
ANY
transactionscount:
77
satcount:
130
above:

25 results

  1. satid:
    2377
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014X
    launchDate:
    1963-05-09
    satlat:
    59.8697
    satlng:
    26.8851
    satalt:
    3285.2995
  2. satid:
    2531
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014AK
    launchDate:
    1963-05-09
    satlat:
    55.4022
    satlng:
    23.1655
    satalt:
    3657.2054
  3. satid:
    2757
    satname:
    ESSA 5
    intDesignator:
    1967-036A
    launchDate:
    1967-04-20
    satlat:
    60.3419
    satlng:
    5.0898
    satalt:
    1413.5361
  4. satid:
    5054
    satname:
    TITAN 34B AGENA D R/B
    intDesignator:
    1971-021B
    launchDate:
    1971-03-21
    satlat:
    53.3987
    satlng:
    -4.9946
    satalt:
    25974.2116
  5. satid:
    5785
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1961-015JZ
    launchDate:
    1961-06-29
    satlat:
    58.3097
    satlng:
    2.7053
    satalt:
    1047.6062
  6. satid:
    7142
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086DG
    launchDate:
    1973-11-06
    satlat:
    61.5314
    satlng:
    5.0127
    satalt:
    1517.5781
  7. satid:
    7532
    satname:
    THORAD DELTA 1 R/B
    intDesignator:
    1974-089D
    launchDate:
    1974-11-15
    satlat:
    59.4824
    satlng:
    -4.6285
    satalt:
    1556.6296
  8. satid:
    7681
    satname:
    COSMOS 714
    intDesignator:
    1975-016D
    launchDate:
    1975-02-28
    satlat:
    61.1792
    satlng:
    11.9793
    satalt:
    1498.655
  9. satid:
    7688
    satname:
    TITAN 34B R/B
    intDesignator:
    1975-017B
    launchDate:
    1975-03-10
    satlat:
    62.752
    satlng:
    45.9198
    satalt:
    14999.2239
  10. satid:
    8195
    satname:
    MOLNIYA 2-14
    intDesignator:
    1975-081A
    launchDate:
    1975-09-09
    satlat:
    47.0784
    satlng:
    39.0795
    satalt:
    30716.2563
  11. satid:
    8612
    satname:
    COSMOS 796
    intDesignator:
    1976-008F
    launchDate:
    1976-01-28
    satlat:
    56.407
    satlng:
    5.9722
    satalt:
    1498.9011
  12. satid:
    9016
    satname:
    SL-8 DEB
    intDesignator:
    1976-067C
    launchDate:
    1976-07-08
    satlat:
    61.4413
    satlng:
    -0.357
    satalt:
    1509.6039
  13. satid:
    9880
    satname:
    MOLNIYA 1-36
    intDesignator:
    1977-021A
    launchDate:
    1977-03-24
    satlat:
    63.7931
    satlng:
    54.6227
    satalt:
    36444.5527
  14. satid:
    9895
    satname:
    COSMOS 862 DEB
    intDesignator:
    1976-105M
    launchDate:
    1976-10-22
    satlat:
    53.1378
    satlng:
    24.8772
    satalt:
    20149.4996
  15. satid:
    10439
    satname:
    COSMOS 839 DEB
    intDesignator:
    1976-067Q
    launchDate:
    1976-07-08
    satlat:
    58.2726
    satlng:
    16.0389
    satalt:
    1600.6467
  16. satid:
    10449
    satname:
    COSMOS 839 DEB
    intDesignator:
    1976-067AA
    launchDate:
    1976-07-08
    satlat:
    65.391
    satlng:
    11.3831
    satalt:
    2091.2163
  17. satid:
    12078
    satname:
    COSMOS 1223
    intDesignator:
    1980-095A
    launchDate:
    1980-11-27
    satlat:
    64.962
    satlng:
    54.4996
    satalt:
    32304.4924
  18. satid:
    12311
    satname:
    SL-6 R/B(2)
    intDesignator:
    1981-016E
    launchDate:
    1981-02-19
    satlat:
    71.8373
    satlng:
    -14.5005
    satalt:
    25857.6869
  19. satid:
    12330
    satname:
    KYOKKO 1 DEB
    intDesignator:
    1978-014D
    launchDate:
    1978-02-04
    satlat:
    60.4516
    satlng:
    -10.9144
    satalt:
    3314.411
  20. satid:
    12889
    satname:
    THOR DELTA 1 R/B
    intDesignator:
    1981-100C
    launchDate:
    1981-10-06
    satlat:
    60.7941
    satlng:
    18.8086
    satalt:
    1725.1898
  21. satid:
    13080
    satname:
    COSMOS 1341
    intDesignator:
    1982-016A
    launchDate:
    1982-03-03
    satlat:
    56.6468
    satlng:
    16.827
    satalt:
    35243.9265
  22. satid:
    13776
    satname:
    COSMOS 397 DEB
    intDesignator:
    1971-015CN
    launchDate:
    1971-02-25
    satlat:
    59.4952
    satlng:
    10.2709
    satalt:
    923.7851
  23. satid:
    13911
    satname:
    SL-6 DEB
    intDesignator:
    1981-088L
    launchDate:
    1981-09-11
    satlat:
    55.5656
    satlng:
    3.2883
    satalt:
    11120.0895
  24. satid:
    14000
    satname:
    COSMOS 931 DEB
    intDesignator:
    1977-068G
    launchDate:
    1977-07-20
    satlat:
    57.673
    satlng:
    19.1245
    satalt:
    15638.1847
  25. satid:
    15095
    satname:
    COSMOS 1581
    intDesignator:
    1984-071A
    launchDate:
    1984-07-03
    satlat:
    49.5365
    satlng:
    28.6184
    satalt:
    18389.9627
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.