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-11T02:05:03Z in 0.726 seconds.

info:

category:: ANY
transactionscount:: 83
satcount:: 123

above:

25 results

satid:
734
satname:
OPS 3367 A
intDesignator:
1964-002B
launchDate:
1964-01-19
satlat:
73.1732
satlng:
19.6599
satalt:
794.4959
satid:
2009
satname:
MIDAS 4 DEB
intDesignator:
1961-028E
launchDate:
1961-10-21
satlat:
69.4071
satlng:
15.217
satalt:
3505.0073
satid:
2412
satname:
ERS 15
intDesignator:
1966-077C
launchDate:
1966-08-19
satlat:
61.9428
satlng:
18.0438
satalt:
3708.1483
satid:
4149
satname:
THORAD AGENA D DEB
intDesignator:
1969-082T
launchDate:
1969-09-30
satlat:
68.3742
satlng:
13.2353
satalt:
849.9682
satid:
4800
satname:
SL-8 R/B
intDesignator:
1970-108B
launchDate:
1970-12-12
satlat:
68.5129
satlng:
10.6486
satalt:
972.8777
satid:
5054
satname:
TITAN 34B AGENA D R/B
intDesignator:
1971-021B
launchDate:
1971-03-21
satlat:
63.5045
satlng:
-6.677
satalt:
36757.9848
satid:
6302
satname:
SL-6 R/B(2)
intDesignator:
1972-072E
launchDate:
1972-09-19
satlat:
57.6367
satlng:
0.2665
satalt:
26778.3673
satid:
6707
satname:
COSMOS 574
intDesignator:
1973-042A
launchDate:
1973-06-20
satlat:
70.0071
satlng:
23.762
satalt:
1011.8597
satid:
6990
satname:
COSMOS 622
intDesignator:
1973-104F
launchDate:
1973-12-19
satlat:
70.5867
satlng:
26.1101
satalt:
1383.5209
satid:
7269
satname:
COSMOS 645
intDesignator:
1974-024E
launchDate:
1974-04-23
satlat:
74.0328
satlng:
19.4554
satalt:
1488.5458
satid:
7276
satname:
MOLNIYA 2-9
intDesignator:
1974-026A
launchDate:
1974-04-26
satlat:
61.8098
satlng:
-21.8177
satalt:
32340.1244
satid:
8195
satname:
MOLNIYA 2-14
intDesignator:
1975-081A
launchDate:
1975-09-09
satlat:
64.5411
satlng:
14.3212
satalt:
34609.9959
satid:
8404
satname:
THORAD DELTA 1 DEB
intDesignator:
1974-089CG
launchDate:
1974-11-15
satlat:
69.8132
satlng:
30.0202
satalt:
1281.0701
satid:
11909
satname:
SL-6 R/B(2)
intDesignator:
1980-063D
launchDate:
1980-07-18
satlat:
63.9076
satlng:
8.2566
satalt:
39349.0756
satid:
12078
satname:
COSMOS 1223
intDesignator:
1980-095A
launchDate:
1980-11-27
satlat:
54.0097
satlng:
-16.7572
satalt:
20856.8948
satid:
12984
satname:
COSMOS 1247 DEB
intDesignator:
1981-016F
launchDate:
1981-02-19
satlat:
68.1128
satlng:
29.4058
satalt:
19007.5872
satid:
13012
satname:
MOLNIYA 1-52
intDesignator:
1981-123A
launchDate:
1981-12-23
satlat:
60.7467
satlng:
68.5872
satalt:
40009.9239
satid:
13016
satname:
SL-6 R/B(2)
intDesignator:
1981-123D
launchDate:
1981-12-23
satlat:
49.8559
satlng:
40.7859
satalt:
31080.0203
satid:
13080
satname:
COSMOS 1341
intDesignator:
1982-016A
launchDate:
1982-03-03
satlat:
68.8589
satlng:
-31.2039
satalt:
24295.3295
satid:
13166
satname:
COSMOS 1363
intDesignator:
1982-040G
launchDate:
1982-05-06
satlat:
73.7983
satlng:
12.3875
satalt:
1510.2576
satid:
13169
satname:
SL-6 R/B(2)
intDesignator:
1982-029D
launchDate:
1982-04-07
satlat:
63.7597
satlng:
18.3457
satalt:
31949.9196
satid:
14615
satname:
COSMOS 1526
intDesignator:
1984-001E
launchDate:
1984-01-05
satlat:
73.263
satlng:
23.023
satalt:
1472.7404
satid:
14734
satname:
COSMOS 1317 DEB
intDesignator:
1981-108E
launchDate:
1981-10-31
satlat:
72.0312
satlng:
85.1811
satalt:
26827.9319
satid:
14884
satname:
COSMOS 1547
intDesignator:
1984-033A
launchDate:
1984-04-04
satlat:
72.4158
satlng:
-20.0797
satalt:
29078.3153
satid:
14979
satname:
COSMOS 1556 (GLONASS)
intDesignator:
1984-047C
launchDate:
1984-05-19
satlat:
55.8247
satlng:
23.3329
satalt:
19148.9321

Show all fields in HTML

info:

category:: ANY
transactionscount:: 83
satcount:: 123

above:

25 results

satid:
734
satname:
OPS 3367 A
intDesignator:
1964-002B
launchDate:
1964-01-19
satlat:
73.1732
satlng:
19.6599
satalt:
794.4959
satid:
2009
satname:
MIDAS 4 DEB
intDesignator:
1961-028E
launchDate:
1961-10-21
satlat:
69.4071
satlng:
15.217
satalt:
3505.0073
satid:
2412
satname:
ERS 15
intDesignator:
1966-077C
launchDate:
1966-08-19
satlat:
61.9428
satlng:
18.0438
satalt:
3708.1483
satid:
4149
satname:
THORAD AGENA D DEB
intDesignator:
1969-082T
launchDate:
1969-09-30
satlat:
68.3742
satlng:
13.2353
satalt:
849.9682
satid:
4800
satname:
SL-8 R/B
intDesignator:
1970-108B
launchDate:
1970-12-12
satlat:
68.5129
satlng:
10.6486
satalt:
972.8777
satid:
5054
satname:
TITAN 34B AGENA D R/B
intDesignator:
1971-021B
launchDate:
1971-03-21
satlat:
63.5045
satlng:
-6.677
satalt:
36757.9848
satid:
6302
satname:
SL-6 R/B(2)
intDesignator:
1972-072E
launchDate:
1972-09-19
satlat:
57.6367
satlng:
0.2665
satalt:
26778.3673
satid:
6707
satname:
COSMOS 574
intDesignator:
1973-042A
launchDate:
1973-06-20
satlat:
70.0071
satlng:
23.762
satalt:
1011.8597
satid:
6990
satname:
COSMOS 622
intDesignator:
1973-104F
launchDate:
1973-12-19
satlat:
70.5867
satlng:
26.1101
satalt:
1383.5209
satid:
7269
satname:
COSMOS 645
intDesignator:
1974-024E
launchDate:
1974-04-23
satlat:
74.0328
satlng:
19.4554
satalt:
1488.5458
satid:
7276
satname:
MOLNIYA 2-9
intDesignator:
1974-026A
launchDate:
1974-04-26
satlat:
61.8098
satlng:
-21.8177
satalt:
32340.1244
satid:
8195
satname:
MOLNIYA 2-14
intDesignator:
1975-081A
launchDate:
1975-09-09
satlat:
64.5411
satlng:
14.3212
satalt:
34609.9959
satid:
8404
satname:
THORAD DELTA 1 DEB
intDesignator:
1974-089CG
launchDate:
1974-11-15
satlat:
69.8132
satlng:
30.0202
satalt:
1281.0701
satid:
11909
satname:
SL-6 R/B(2)
intDesignator:
1980-063D
launchDate:
1980-07-18
satlat:
63.9076
satlng:
8.2566
satalt:
39349.0756
satid:
12078
satname:
COSMOS 1223
intDesignator:
1980-095A
launchDate:
1980-11-27
satlat:
54.0097
satlng:
-16.7572
satalt:
20856.8948
satid:
12984
satname:
COSMOS 1247 DEB
intDesignator:
1981-016F
launchDate:
1981-02-19
satlat:
68.1128
satlng:
29.4058
satalt:
19007.5872
satid:
13012
satname:
MOLNIYA 1-52
intDesignator:
1981-123A
launchDate:
1981-12-23
satlat:
60.7467
satlng:
68.5872
satalt:
40009.9239
satid:
13016
satname:
SL-6 R/B(2)
intDesignator:
1981-123D
launchDate:
1981-12-23
satlat:
49.8559
satlng:
40.7859
satalt:
31080.0203
satid:
13080
satname:
COSMOS 1341
intDesignator:
1982-016A
launchDate:
1982-03-03
satlat:
68.8589
satlng:
-31.2039
satalt:
24295.3295
satid:
13166
satname:
COSMOS 1363
intDesignator:
1982-040G
launchDate:
1982-05-06
satlat:
73.7983
satlng:
12.3875
satalt:
1510.2576
satid:
13169
satname:
SL-6 R/B(2)
intDesignator:
1982-029D
launchDate:
1982-04-07
satlat:
63.7597
satlng:
18.3457
satalt:
31949.9196
satid:
14615
satname:
COSMOS 1526
intDesignator:
1984-001E
launchDate:
1984-01-05
satlat:
73.263
satlng:
23.023
satalt:
1472.7404
satid:
14734
satname:
COSMOS 1317 DEB
intDesignator:
1981-108E
launchDate:
1981-10-31
satlat:
72.0312
satlng:
85.1811
satalt:
26827.9319
satid:
14884
satname:
COSMOS 1547
intDesignator:
1984-033A
launchDate:
1984-04-04
satlat:
72.4158
satlng:
-20.0797
satalt:
29078.3153
satid:
14979
satname:
COSMOS 1556 (GLONASS)
intDesignator:
1984-047C
launchDate:
1984-05-19
satlat:
55.8247
satlng:
23.3329
satalt:
19148.9321

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.