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-16T15:17:22Z in 1.452 seconds.

info:
category:
ANY
transactionscount:
98
satcount:
120
above:

25 results

  1. satid:
    3686
    satname:
    COSMOS 252 DEB *
    intDesignator:
    1968-097AD
    launchDate:
    1968-11-01
    satlat:
    60.1701
    satlng:
    10.0665
    satalt:
    1226.0583
  2. satid:
    3767
    satname:
    DELTA 1 R/B
    intDesignator:
    1969-016B
    launchDate:
    1969-02-26
    satlat:
    64.6707
    satlng:
    18.3496
    satalt:
    1435.3808
  3. satid:
    4635
    satname:
    COSMOS 375 DEB
    intDesignator:
    1970-091M
    launchDate:
    1970-10-30
    satlat:
    62.8854
    satlng:
    19.3492
    satalt:
    1782.6301
  4. satid:
    4977
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025GX
    launchDate:
    1970-04-08
    satlat:
    62.4371
    satlng:
    20.3766
    satalt:
    1086.8669
  5. satid:
    5018
    satname:
    COSMOS 397 DEB
    intDesignator:
    1971-015M
    launchDate:
    1971-02-25
    satlat:
    57.6549
    satlng:
    12.2652
    satalt:
    1300.158
  6. satid:
    7800
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-036D
    launchDate:
    1975-04-29
    satlat:
    40.3107
    satlng:
    32.8599
    satalt:
    27899.4706
  7. satid:
    8601
    satname:
    MOLNIYA 1-32
    intDesignator:
    1976-006A
    launchDate:
    1976-01-22
    satlat:
    54.7913
    satlng:
    3.8506
    satalt:
    33709.0062
  8. satid:
    9652
    satname:
    COSMOS 886 DEB
    intDesignator:
    1976-126J
    launchDate:
    1976-12-27
    satlat:
    62.769
    satlng:
    11.9156
    satalt:
    1891.4776
  9. satid:
    9984
    satname:
    THORAD DELTA 1 DEB
    intDesignator:
    1974-089EB
    launchDate:
    1974-11-15
    satlat:
    60.3727
    satlng:
    11.7673
    satalt:
    1564.9556
  10. satid:
    10358
    satname:
    COSMOS 952
    intDesignator:
    1977-088A
    launchDate:
    1977-09-16
    satlat:
    64.9672
    satlng:
    10.6604
    satalt:
    980.5027
  11. satid:
    10776
    satname:
    COSMOS 1000
    intDesignator:
    1978-034A
    launchDate:
    1978-03-31
    satlat:
    61.7638
    satlng:
    16.9505
    satalt:
    994.939
  12. satid:
    11302
    satname:
    COSMOS 1087
    intDesignator:
    1979-024G
    launchDate:
    1979-03-15
    satlat:
    61.7494
    satlng:
    14.6458
    satalt:
    1491.9976
  13. satid:
    12189
    satname:
    DELTA 1 DEB
    intDesignator:
    1978-026AE
    launchDate:
    1978-03-05
    satlat:
    60.6951
    satlng:
    3.2479
    satalt:
    889.7223
  14. satid:
    12376
    satname:
    COSMOS 1261
    intDesignator:
    1981-031A
    launchDate:
    1981-03-31
    satlat:
    51.6035
    satlng:
    -20.6327
    satalt:
    23748.1447
  15. satid:
    13124
    satname:
    COSMOS 1348
    intDesignator:
    1982-029A
    launchDate:
    1982-04-07
    satlat:
    61.4739
    satlng:
    29.3962
    satalt:
    26964.0054
  16. satid:
    13897
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-019D
    launchDate:
    1983-03-16
    satlat:
    56.9464
    satlng:
    61.2419
    satalt:
    37001.7557
  17. satid:
    13904
    satname:
    SL-6 DEB
    intDesignator:
    1981-088G
    launchDate:
    1981-09-11
    satlat:
    61.9582
    satlng:
    -6.7665
    satalt:
    11537.9533
  18. satid:
    15738
    satname:
    MOLNIYA 3-24
    intDesignator:
    1985-040A
    launchDate:
    1985-05-29
    satlat:
    57.5289
    satlng:
    -2.5385
    satalt:
    23681.2625
  19. satid:
    16445
    satname:
    SL-12 R/B(AUX MOTOR)
    intDesignator:
    1985-118K
    launchDate:
    1985-12-24
    satlat:
    61.6211
    satlng:
    5.0264
    satalt:
    6403.3275
  20. satid:
    17081
    satname:
    SL-6 R/B(2)
    intDesignator:
    1986-089D
    launchDate:
    1986-11-15
    satlat:
    62.4192
    satlng:
    -33.115
    satalt:
    30972.2218
  21. satid:
    17159
    satname:
    COSMOS 1802
    intDesignator:
    1986-093A
    launchDate:
    1986-11-24
    satlat:
    59.5201
    satlng:
    4.5149
    satalt:
    970.1317
  22. satid:
    17328
    satname:
    MOLNIYA 3-31
    intDesignator:
    1987-008A
    launchDate:
    1987-01-22
    satlat:
    57.8071
    satlng:
    57.2979
    satalt:
    38289.346
  23. satid:
    17997
    satname:
    USA 22
    intDesignator:
    1987-043A
    launchDate:
    1987-05-15
    satlat:
    61.1032
    satlng:
    10.8835
    satalt:
    435.1098
  24. satid:
    18940
    satname:
    COSMOS 1927
    intDesignator:
    1988-016D
    launchDate:
    1988-03-11
    satlat:
    57.6394
    satlng:
    8.4189
    satalt:
    1468.335
  25. satid:
    18949
    satname:
    SL-6 R/B(2)
    intDesignator:
    1988-017D
    launchDate:
    1988-03-11
    satlat:
    55.4455
    satlng:
    -26.9912
    satalt:
    34871.8818
limit:
25
offset:
0
returned:
25
has_more_results:
yes
next_offset:
25
Show all fields in HTML
info:
category:
ANY
transactionscount:
98
satcount:
120
above:

25 results

  1. satid:
    3686
    satname:
    COSMOS 252 DEB *
    intDesignator:
    1968-097AD
    launchDate:
    1968-11-01
    satlat:
    60.1701
    satlng:
    10.0665
    satalt:
    1226.0583
  2. satid:
    3767
    satname:
    DELTA 1 R/B
    intDesignator:
    1969-016B
    launchDate:
    1969-02-26
    satlat:
    64.6707
    satlng:
    18.3496
    satalt:
    1435.3808
  3. satid:
    4635
    satname:
    COSMOS 375 DEB
    intDesignator:
    1970-091M
    launchDate:
    1970-10-30
    satlat:
    62.8854
    satlng:
    19.3492
    satalt:
    1782.6301
  4. satid:
    4977
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025GX
    launchDate:
    1970-04-08
    satlat:
    62.4371
    satlng:
    20.3766
    satalt:
    1086.8669
  5. satid:
    5018
    satname:
    COSMOS 397 DEB
    intDesignator:
    1971-015M
    launchDate:
    1971-02-25
    satlat:
    57.6549
    satlng:
    12.2652
    satalt:
    1300.158
  6. satid:
    7800
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-036D
    launchDate:
    1975-04-29
    satlat:
    40.3107
    satlng:
    32.8599
    satalt:
    27899.4706
  7. satid:
    8601
    satname:
    MOLNIYA 1-32
    intDesignator:
    1976-006A
    launchDate:
    1976-01-22
    satlat:
    54.7913
    satlng:
    3.8506
    satalt:
    33709.0062
  8. satid:
    9652
    satname:
    COSMOS 886 DEB
    intDesignator:
    1976-126J
    launchDate:
    1976-12-27
    satlat:
    62.769
    satlng:
    11.9156
    satalt:
    1891.4776
  9. satid:
    9984
    satname:
    THORAD DELTA 1 DEB
    intDesignator:
    1974-089EB
    launchDate:
    1974-11-15
    satlat:
    60.3727
    satlng:
    11.7673
    satalt:
    1564.9556
  10. satid:
    10358
    satname:
    COSMOS 952
    intDesignator:
    1977-088A
    launchDate:
    1977-09-16
    satlat:
    64.9672
    satlng:
    10.6604
    satalt:
    980.5027
  11. satid:
    10776
    satname:
    COSMOS 1000
    intDesignator:
    1978-034A
    launchDate:
    1978-03-31
    satlat:
    61.7638
    satlng:
    16.9505
    satalt:
    994.939
  12. satid:
    11302
    satname:
    COSMOS 1087
    intDesignator:
    1979-024G
    launchDate:
    1979-03-15
    satlat:
    61.7494
    satlng:
    14.6458
    satalt:
    1491.9976
  13. satid:
    12189
    satname:
    DELTA 1 DEB
    intDesignator:
    1978-026AE
    launchDate:
    1978-03-05
    satlat:
    60.6951
    satlng:
    3.2479
    satalt:
    889.7223
  14. satid:
    12376
    satname:
    COSMOS 1261
    intDesignator:
    1981-031A
    launchDate:
    1981-03-31
    satlat:
    51.6035
    satlng:
    -20.6327
    satalt:
    23748.1447
  15. satid:
    13124
    satname:
    COSMOS 1348
    intDesignator:
    1982-029A
    launchDate:
    1982-04-07
    satlat:
    61.4739
    satlng:
    29.3962
    satalt:
    26964.0054
  16. satid:
    13897
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-019D
    launchDate:
    1983-03-16
    satlat:
    56.9464
    satlng:
    61.2419
    satalt:
    37001.7557
  17. satid:
    13904
    satname:
    SL-6 DEB
    intDesignator:
    1981-088G
    launchDate:
    1981-09-11
    satlat:
    61.9582
    satlng:
    -6.7665
    satalt:
    11537.9533
  18. satid:
    15738
    satname:
    MOLNIYA 3-24
    intDesignator:
    1985-040A
    launchDate:
    1985-05-29
    satlat:
    57.5289
    satlng:
    -2.5385
    satalt:
    23681.2625
  19. satid:
    16445
    satname:
    SL-12 R/B(AUX MOTOR)
    intDesignator:
    1985-118K
    launchDate:
    1985-12-24
    satlat:
    61.6211
    satlng:
    5.0264
    satalt:
    6403.3275
  20. satid:
    17081
    satname:
    SL-6 R/B(2)
    intDesignator:
    1986-089D
    launchDate:
    1986-11-15
    satlat:
    62.4192
    satlng:
    -33.115
    satalt:
    30972.2218
  21. satid:
    17159
    satname:
    COSMOS 1802
    intDesignator:
    1986-093A
    launchDate:
    1986-11-24
    satlat:
    59.5201
    satlng:
    4.5149
    satalt:
    970.1317
  22. satid:
    17328
    satname:
    MOLNIYA 3-31
    intDesignator:
    1987-008A
    launchDate:
    1987-01-22
    satlat:
    57.8071
    satlng:
    57.2979
    satalt:
    38289.346
  23. satid:
    17997
    satname:
    USA 22
    intDesignator:
    1987-043A
    launchDate:
    1987-05-15
    satlat:
    61.1032
    satlng:
    10.8835
    satalt:
    435.1098
  24. satid:
    18940
    satname:
    COSMOS 1927
    intDesignator:
    1988-016D
    launchDate:
    1988-03-11
    satlat:
    57.6394
    satlng:
    8.4189
    satalt:
    1468.335
  25. satid:
    18949
    satname:
    SL-6 R/B(2)
    intDesignator:
    1988-017D
    launchDate:
    1988-03-11
    satlat:
    55.4455
    satlng:
    -26.9912
    satalt:
    34871.8818
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.