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-19T21:05:22Z in 1.041 seconds.

info:
category:
ANY
transactionscount:
91
satcount:
118
above:

25 results

  1. satid:
    2361
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014L
    launchDate:
    1963-05-09
    satlat:
    52.1205
    satlng:
    1.0935
    satalt:
    3486.1622
  2. satid:
    3174
    satname:
    OV1-14
    intDesignator:
    1968-026B
    launchDate:
    1968-04-06
    satlat:
    58.0747
    satlng:
    36.5696
    satalt:
    8362.2881
  3. satid:
    3825
    satname:
    OV1-19
    intDesignator:
    1969-025C
    launchDate:
    1969-03-18
    satlat:
    65.444
    satlng:
    3.0822
    satalt:
    5041.2212
  4. satid:
    4841
    satname:
    DELTA 1 DEB
    intDesignator:
    1968-055D
    launchDate:
    1968-07-04
    satlat:
    58.2681
    satlng:
    9.8378
    satalt:
    5722.3533
  5. satid:
    6302
    satname:
    SL-6 R/B(2)
    intDesignator:
    1972-072E
    launchDate:
    1972-09-19
    satlat:
    67.1294
    satlng:
    14.1118
    satalt:
    33957.5841
  6. satid:
    7629
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-007D
    launchDate:
    1975-01-30
    satlat:
    44.3261
    satlng:
    39.3561
    satalt:
    32790.5857
  7. satid:
    8435
    satname:
    THORAD DELTA 1 DEB
    intDesignator:
    1974-089CL
    launchDate:
    1974-11-15
    satlat:
    58.7163
    satlng:
    2.05
    satalt:
    1729.5482
  8. satid:
    8897
    satname:
    SL-8 R/B
    intDesignator:
    1976-054J
    launchDate:
    1976-06-15
    satlat:
    58.4261
    satlng:
    9.4397
    satalt:
    1498.4721
  9. satid:
    9271
    satname:
    TITAN 34B AGENA R/B
    intDesignator:
    1976-080B
    launchDate:
    1976-08-06
    satlat:
    63.2827
    satlng:
    -33.9685
    satalt:
    25027.4889
  10. satid:
    9823
    satname:
    COSMOS 886 DEB
    intDesignator:
    1976-126AK
    launchDate:
    1976-12-27
    satlat:
    63.865
    satlng:
    1.6643
    satalt:
    1725.8889
  11. satid:
    9848
    satname:
    SL-8 R/B
    intDesignator:
    1977-013B
    launchDate:
    1977-02-21
    satlat:
    59.6375
    satlng:
    6.6719
    satalt:
    976.5109
  12. satid:
    11079
    satname:
    SL-6 R/B(2)
    intDesignator:
    1978-095E
    launchDate:
    1978-10-13
    satlat:
    60.7474
    satlng:
    30.7891
    satalt:
    33835.1089
  13. satid:
    11085
    satname:
    RADIO 1
    intDesignator:
    1978-100B
    launchDate:
    1978-10-26
    satlat:
    52.6802
    satlng:
    1.0628
    satalt:
    1695.468
  14. satid:
    11304
    satname:
    SL-8 R/B
    intDesignator:
    1979-024J
    launchDate:
    1979-03-15
    satlat:
    52.0963
    satlng:
    2.5969
    satalt:
    1557.9439
  15. satid:
    11735
    satname:
    COSMOS 1168
    intDesignator:
    1980-022A
    launchDate:
    1980-03-17
    satlat:
    57.3202
    satlng:
    6.3292
    satalt:
    998.1737
  16. satid:
    12534
    satname:
    DELTA 1 DEB
    intDesignator:
    1976-077DP
    launchDate:
    1976-07-29
    satlat:
    54.8225
    satlng:
    -3.8411
    satalt:
    1574.1269
  17. satid:
    12553
    satname:
    NOAA 7
    intDesignator:
    1981-059A
    launchDate:
    1981-06-23
    satlat:
    54.9679
    satlng:
    1.3839
    satalt:
    847.9347
  18. satid:
    12827
    satname:
    SL-6 R/B(2)
    intDesignator:
    1981-088F
    launchDate:
    1981-09-11
    satlat:
    53.0156
    satlng:
    -5.2627
    satalt:
    13743.5367
  19. satid:
    12865
    satname:
    COSMOS 970 DEB
    intDesignator:
    1977-121AT
    launchDate:
    1977-12-21
    satlat:
    59.2385
    satlng:
    7.6552
    satalt:
    1021.4904
  20. satid:
    13375
    satname:
    COSMOS 1388
    intDesignator:
    1982-073A
    launchDate:
    1982-07-21
    satlat:
    62.8931
    satlng:
    11.6642
    satalt:
    1475.9822
  21. satid:
    14191
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-070D
    launchDate:
    1983-07-08
    satlat:
    69.1212
    satlng:
    16.5595
    satalt:
    26956.3651
  22. satid:
    14590
    satname:
    COSMOS 1519 (GLONASS)
    intDesignator:
    1983-127A
    launchDate:
    1983-12-29
    satlat:
    41.2378
    satlng:
    2.9101
    satalt:
    19158.8229
  23. satid:
    14592
    satname:
    COSMOS 1521 (GLONASS)
    intDesignator:
    1983-127C
    launchDate:
    1983-12-29
    satlat:
    52.1758
    satlng:
    10.5043
    satalt:
    19184.6936
  24. satid:
    14608
    satname:
    SL-12 R/B(AUX MOTOR)
    intDesignator:
    1983-127H
    launchDate:
    1983-12-29
    satlat:
    46.2198
    satlng:
    16.8134
    satalt:
    14865.4285
  25. satid:
    14715
    satname:
    OPS 4682 DEB
    intDesignator:
    1965-027N
    launchDate:
    1965-04-03
    satlat:
    54.1309
    satlng:
    6.7459
    satalt:
    1295.8177
limit:
25
offset:
0
returned:
25
has_more_results:
yes
next_offset:
25
Show all fields in HTML
info:
category:
ANY
transactionscount:
91
satcount:
118
above:

25 results

  1. satid:
    2361
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014L
    launchDate:
    1963-05-09
    satlat:
    52.1205
    satlng:
    1.0935
    satalt:
    3486.1622
  2. satid:
    3174
    satname:
    OV1-14
    intDesignator:
    1968-026B
    launchDate:
    1968-04-06
    satlat:
    58.0747
    satlng:
    36.5696
    satalt:
    8362.2881
  3. satid:
    3825
    satname:
    OV1-19
    intDesignator:
    1969-025C
    launchDate:
    1969-03-18
    satlat:
    65.444
    satlng:
    3.0822
    satalt:
    5041.2212
  4. satid:
    4841
    satname:
    DELTA 1 DEB
    intDesignator:
    1968-055D
    launchDate:
    1968-07-04
    satlat:
    58.2681
    satlng:
    9.8378
    satalt:
    5722.3533
  5. satid:
    6302
    satname:
    SL-6 R/B(2)
    intDesignator:
    1972-072E
    launchDate:
    1972-09-19
    satlat:
    67.1294
    satlng:
    14.1118
    satalt:
    33957.5841
  6. satid:
    7629
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-007D
    launchDate:
    1975-01-30
    satlat:
    44.3261
    satlng:
    39.3561
    satalt:
    32790.5857
  7. satid:
    8435
    satname:
    THORAD DELTA 1 DEB
    intDesignator:
    1974-089CL
    launchDate:
    1974-11-15
    satlat:
    58.7163
    satlng:
    2.05
    satalt:
    1729.5482
  8. satid:
    8897
    satname:
    SL-8 R/B
    intDesignator:
    1976-054J
    launchDate:
    1976-06-15
    satlat:
    58.4261
    satlng:
    9.4397
    satalt:
    1498.4721
  9. satid:
    9271
    satname:
    TITAN 34B AGENA R/B
    intDesignator:
    1976-080B
    launchDate:
    1976-08-06
    satlat:
    63.2827
    satlng:
    -33.9685
    satalt:
    25027.4889
  10. satid:
    9823
    satname:
    COSMOS 886 DEB
    intDesignator:
    1976-126AK
    launchDate:
    1976-12-27
    satlat:
    63.865
    satlng:
    1.6643
    satalt:
    1725.8889
  11. satid:
    9848
    satname:
    SL-8 R/B
    intDesignator:
    1977-013B
    launchDate:
    1977-02-21
    satlat:
    59.6375
    satlng:
    6.6719
    satalt:
    976.5109
  12. satid:
    11079
    satname:
    SL-6 R/B(2)
    intDesignator:
    1978-095E
    launchDate:
    1978-10-13
    satlat:
    60.7474
    satlng:
    30.7891
    satalt:
    33835.1089
  13. satid:
    11085
    satname:
    RADIO 1
    intDesignator:
    1978-100B
    launchDate:
    1978-10-26
    satlat:
    52.6802
    satlng:
    1.0628
    satalt:
    1695.468
  14. satid:
    11304
    satname:
    SL-8 R/B
    intDesignator:
    1979-024J
    launchDate:
    1979-03-15
    satlat:
    52.0963
    satlng:
    2.5969
    satalt:
    1557.9439
  15. satid:
    11735
    satname:
    COSMOS 1168
    intDesignator:
    1980-022A
    launchDate:
    1980-03-17
    satlat:
    57.3202
    satlng:
    6.3292
    satalt:
    998.1737
  16. satid:
    12534
    satname:
    DELTA 1 DEB
    intDesignator:
    1976-077DP
    launchDate:
    1976-07-29
    satlat:
    54.8225
    satlng:
    -3.8411
    satalt:
    1574.1269
  17. satid:
    12553
    satname:
    NOAA 7
    intDesignator:
    1981-059A
    launchDate:
    1981-06-23
    satlat:
    54.9679
    satlng:
    1.3839
    satalt:
    847.9347
  18. satid:
    12827
    satname:
    SL-6 R/B(2)
    intDesignator:
    1981-088F
    launchDate:
    1981-09-11
    satlat:
    53.0156
    satlng:
    -5.2627
    satalt:
    13743.5367
  19. satid:
    12865
    satname:
    COSMOS 970 DEB
    intDesignator:
    1977-121AT
    launchDate:
    1977-12-21
    satlat:
    59.2385
    satlng:
    7.6552
    satalt:
    1021.4904
  20. satid:
    13375
    satname:
    COSMOS 1388
    intDesignator:
    1982-073A
    launchDate:
    1982-07-21
    satlat:
    62.8931
    satlng:
    11.6642
    satalt:
    1475.9822
  21. satid:
    14191
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-070D
    launchDate:
    1983-07-08
    satlat:
    69.1212
    satlng:
    16.5595
    satalt:
    26956.3651
  22. satid:
    14590
    satname:
    COSMOS 1519 (GLONASS)
    intDesignator:
    1983-127A
    launchDate:
    1983-12-29
    satlat:
    41.2378
    satlng:
    2.9101
    satalt:
    19158.8229
  23. satid:
    14592
    satname:
    COSMOS 1521 (GLONASS)
    intDesignator:
    1983-127C
    launchDate:
    1983-12-29
    satlat:
    52.1758
    satlng:
    10.5043
    satalt:
    19184.6936
  24. satid:
    14608
    satname:
    SL-12 R/B(AUX MOTOR)
    intDesignator:
    1983-127H
    launchDate:
    1983-12-29
    satlat:
    46.2198
    satlng:
    16.8134
    satalt:
    14865.4285
  25. satid:
    14715
    satname:
    OPS 4682 DEB
    intDesignator:
    1965-027N
    launchDate:
    1965-04-03
    satlat:
    54.1309
    satlng:
    6.7459
    satalt:
    1295.8177
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.