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.

Parameter	Requirement	JSON type	Description
`observer_lat`	required	number	Observer latitude in WGS84 decimal degrees. Unit: decimal degrees (WGS84).
`observer_lon`	required	number	Observer longitude in WGS84 decimal degrees. Unit: decimal degrees (WGS84).
`observer_alt_m`	optional	number	Observer altitude above sea level in metres. Unit: metres.
`radius_deg`	optional	integer	Search radius from 0 to 90 degrees. Unit: degrees.
`category_id`	optional	integer	N2YO category id; 0 means all categories, 1 brightest.
`limit`	optional	integer	Gateway page size; default 25, maximum 100.
`offset`	optional	integer	Number 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.

Result

Source: N2YO satellite data. Retrieved 2026-11-14T00:05:03Z in 1.038 seconds.

info:

category:: ANY
transactionscount:: 9
satcount:: 123

above:

25 results

satid:
2422
satname:
THOR BURNER 2 R/B
intDesignator:
1966-082B
launchDate:
1966-09-16
satlat:
70.3797
satlng:
30.7003
satalt:
685.5357
satid:
3173
satname:
OV1-13
intDesignator:
1968-026A
launchDate:
1968-04-06
satlat:
59.7997
satlng:
11.072
satalt:
4819.5097
satid:
3341
satname:
SCOUT B R/B
intDesignator:
1968-066C
launchDate:
1968-08-08
satlat:
71.1766
satlng:
33.8942
satalt:
2323.6747
satid:
3673
satname:
OPS 2644
intDesignator:
1969-010B
launchDate:
1969-02-05
satlat:
72.1791
satlng:
23.463
satalt:
1408.873
satid:
6268
satname:
COSMOS 533
intDesignator:
1972-087F
launchDate:
1972-11-01
satlat:
73.9437
satlng:
24.3512
satalt:
1353.3345
satid:
6302
satname:
SL-6 R/B(2)
intDesignator:
1972-072E
launchDate:
1972-09-19
satlat:
64.5097
satlng:
12.2787
satalt:
29786.839
satid:
6910
satname:
SCOUT A-1 R/B
intDesignator:
1973-081B
launchDate:
1973-10-30
satlat:
70.5409
satlng:
13.3504
satalt:
1054.8358
satid:
7276
satname:
MOLNIYA 2-9
intDesignator:
1974-026A
launchDate:
1974-04-26
satlat:
64.2623
satlng:
36.5374
satalt:
31090.6123
satid:
7434
satname:
SL-8 R/B
intDesignator:
1974-071B
launchDate:
1974-09-11
satlat:
71.8275
satlng:
22.8567
satalt:
773.8651
satid:
7685
satname:
COSMOS 718
intDesignator:
1975-016H
launchDate:
1975-02-28
satlat:
69.5956
satlng:
15.0534
satalt:
1467.6825
satid:
8195
satname:
MOLNIYA 2-14
intDesignator:
1975-081A
launchDate:
1975-09-09
satlat:
59.2923
satlng:
14.2503
satalt:
28196.6805
satid:
9890
satname:
COSMOS 862 DEB
intDesignator:
1976-105G
launchDate:
1976-10-22
satlat:
54.3695
satlng:
-13.4288
satalt:
22402.7284
satid:
11051
satname:
SL-8 R/B
intDesignator:
1978-091J
launchDate:
1978-10-04
satlat:
73.3706
satlng:
17.6323
satalt:
1495.6965
satid:
11129
satname:
COSMOS 1052
intDesignator:
1978-109B
launchDate:
1978-12-05
satlat:
72.2347
satlng:
13.4093
satalt:
1500.3529
satid:
11539
satname:
COSMOS 1131
intDesignator:
1979-084B
launchDate:
1979-09-25
satlat:
65.1328
satlng:
26.7842
satalt:
1487.9889
satid:
11690
satname:
OPS 5117 (NAVSTAR 5)
intDesignator:
1980-011A
launchDate:
1980-02-09
satlat:
51.7887
satlng:
26.1217
satalt:
21241.2231
satid:
11847
satname:
SL-6 R/B(2)
intDesignator:
1980-050B
launchDate:
1980-06-14
satlat:
60.5969
satlng:
74.2102
satalt:
34315.1767
satid:
12636
satname:
COSMOS 1287
intDesignator:
1981-074A
launchDate:
1981-08-06
satlat:
73.3951
satlng:
25.0884
satalt:
1489.7757
satid:
12644
satname:
SL-8 R/B
intDesignator:
1981-074J
launchDate:
1981-08-06
satlat:
71.5474
satlng:
28.5996
satalt:
1681.6385
satid:
13012
satname:
MOLNIYA 1-52
intDesignator:
1981-123A
launchDate:
1981-12-23
satlat:
61.7188
satlng:
69.8587
satalt:
36587.6873
satid:
13169
satname:
SL-6 R/B(2)
intDesignator:
1982-029D
launchDate:
1982-04-07
satlat:
68.2499
satlng:
32.1469
satalt:
30322.9305
satid:
13610
satname:
SL-12 R/B(2)
intDesignator:
1982-100H
launchDate:
1982-10-12
satlat:
57.2777
satlng:
52.5953
satalt:
19081.5974
satid:
14174
satname:
COSMOS 1476
intDesignator:
1983-069D
launchDate:
1983-07-06
satlat:
68.9742
satlng:
26.6857
satalt:
1471.4297
satid:
14734
satname:
COSMOS 1317 DEB
intDesignator:
1981-108E
launchDate:
1981-10-31
satlat:
60.1345
satlng:
38.4633
satalt:
19397.0515
satid:
14984
satname:
SL-12 R/B(2)
intDesignator:
1984-047F
launchDate:
1984-05-19
satlat:
65.95
satlng:
9.9947
satalt:
19155.6591

Show all fields in HTML

info:

category:: ANY
transactionscount:: 9
satcount:: 123

above:

25 results

satid:
2422
satname:
THOR BURNER 2 R/B
intDesignator:
1966-082B
launchDate:
1966-09-16
satlat:
70.3797
satlng:
30.7003
satalt:
685.5357
satid:
3173
satname:
OV1-13
intDesignator:
1968-026A
launchDate:
1968-04-06
satlat:
59.7997
satlng:
11.072
satalt:
4819.5097
satid:
3341
satname:
SCOUT B R/B
intDesignator:
1968-066C
launchDate:
1968-08-08
satlat:
71.1766
satlng:
33.8942
satalt:
2323.6747
satid:
3673
satname:
OPS 2644
intDesignator:
1969-010B
launchDate:
1969-02-05
satlat:
72.1791
satlng:
23.463
satalt:
1408.873
satid:
6268
satname:
COSMOS 533
intDesignator:
1972-087F
launchDate:
1972-11-01
satlat:
73.9437
satlng:
24.3512
satalt:
1353.3345
satid:
6302
satname:
SL-6 R/B(2)
intDesignator:
1972-072E
launchDate:
1972-09-19
satlat:
64.5097
satlng:
12.2787
satalt:
29786.839
satid:
6910
satname:
SCOUT A-1 R/B
intDesignator:
1973-081B
launchDate:
1973-10-30
satlat:
70.5409
satlng:
13.3504
satalt:
1054.8358
satid:
7276
satname:
MOLNIYA 2-9
intDesignator:
1974-026A
launchDate:
1974-04-26
satlat:
64.2623
satlng:
36.5374
satalt:
31090.6123
satid:
7434
satname:
SL-8 R/B
intDesignator:
1974-071B
launchDate:
1974-09-11
satlat:
71.8275
satlng:
22.8567
satalt:
773.8651
satid:
7685
satname:
COSMOS 718
intDesignator:
1975-016H
launchDate:
1975-02-28
satlat:
69.5956
satlng:
15.0534
satalt:
1467.6825
satid:
8195
satname:
MOLNIYA 2-14
intDesignator:
1975-081A
launchDate:
1975-09-09
satlat:
59.2923
satlng:
14.2503
satalt:
28196.6805
satid:
9890
satname:
COSMOS 862 DEB
intDesignator:
1976-105G
launchDate:
1976-10-22
satlat:
54.3695
satlng:
-13.4288
satalt:
22402.7284
satid:
11051
satname:
SL-8 R/B
intDesignator:
1978-091J
launchDate:
1978-10-04
satlat:
73.3706
satlng:
17.6323
satalt:
1495.6965
satid:
11129
satname:
COSMOS 1052
intDesignator:
1978-109B
launchDate:
1978-12-05
satlat:
72.2347
satlng:
13.4093
satalt:
1500.3529
satid:
11539
satname:
COSMOS 1131
intDesignator:
1979-084B
launchDate:
1979-09-25
satlat:
65.1328
satlng:
26.7842
satalt:
1487.9889
satid:
11690
satname:
OPS 5117 (NAVSTAR 5)
intDesignator:
1980-011A
launchDate:
1980-02-09
satlat:
51.7887
satlng:
26.1217
satalt:
21241.2231
satid:
11847
satname:
SL-6 R/B(2)
intDesignator:
1980-050B
launchDate:
1980-06-14
satlat:
60.5969
satlng:
74.2102
satalt:
34315.1767
satid:
12636
satname:
COSMOS 1287
intDesignator:
1981-074A
launchDate:
1981-08-06
satlat:
73.3951
satlng:
25.0884
satalt:
1489.7757
satid:
12644
satname:
SL-8 R/B
intDesignator:
1981-074J
launchDate:
1981-08-06
satlat:
71.5474
satlng:
28.5996
satalt:
1681.6385
satid:
13012
satname:
MOLNIYA 1-52
intDesignator:
1981-123A
launchDate:
1981-12-23
satlat:
61.7188
satlng:
69.8587
satalt:
36587.6873
satid:
13169
satname:
SL-6 R/B(2)
intDesignator:
1982-029D
launchDate:
1982-04-07
satlat:
68.2499
satlng:
32.1469
satalt:
30322.9305
satid:
13610
satname:
SL-12 R/B(2)
intDesignator:
1982-100H
launchDate:
1982-10-12
satlat:
57.2777
satlng:
52.5953
satalt:
19081.5974
satid:
14174
satname:
COSMOS 1476
intDesignator:
1983-069D
launchDate:
1983-07-06
satlat:
68.9742
satlng:
26.6857
satalt:
1471.4297
satid:
14734
satname:
COSMOS 1317 DEB
intDesignator:
1981-108E
launchDate:
1981-10-31
satlat:
60.1345
satlng:
38.4633
satalt:
19397.0515
satid:
14984
satname:
SL-12 R/B(2)
intDesignator:
1984-047F
launchDate:
1984-05-19
satlat:
65.95
satlng:
9.9947
satalt:
19155.6591

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

Replace the placeholders in the HTML GET template; remove optional parameters you do not need.
Check types, units, limits and ID formats in the parameter table.
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

State the NORAD ID, observer coordinate, altitude and time window. A pass is observer-dependent.

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.