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-10-15T04:00:55Z in 3.509 seconds.

info:

category:: ANY
transactionscount:: 15
satcount:: 139

above:

25 results

satid:
159
satname:
THOR ABLESTAR DEB
intDesignator:
1961-015AV
launchDate:
1961-06-29
satlat:
58.524
satlng:
17.6286
satalt:
988.0493
satid:
273
satname:
MIDAS 5 DEB
intDesignator:
1962-010C
launchDate:
1962-04-09
satlat:
53.8347
satlng:
10.8653
satalt:
2902.8752
satid:
746
satname:
ELEKTRON 1
intDesignator:
1964-006A
launchDate:
1964-01-30
satlat:
55.7426
satlng:
-3.8426
satalt:
6177.593
satid:
1459
satname:
OPS 6564 (VELA 6)
intDesignator:
1965-058B
launchDate:
1965-07-20
satlat:
40.7244
satlng:
-12.9656
satalt:
56606.1967
satid:
2700
satname:
DELTA 1 DEB
intDesignator:
1965-089C
launchDate:
1965-11-06
satlat:
57.738
satlng:
4.8949
satalt:
1462.5083
satid:
2802
satname:
SL-8 R/B
intDesignator:
1967-045B
launchDate:
1967-05-15
satlat:
59.634
satlng:
5.1142
satalt:
783.1976
satid:
7079
satname:
DELTA 1 DEB
intDesignator:
1973-086BX
launchDate:
1973-11-06
satlat:
57.857
satlng:
5.8168
satalt:
1563.5926
satid:
7276
satname:
MOLNIYA 2-9
intDesignator:
1974-026A
launchDate:
1974-04-26
satlat:
62.6629
satlng:
-15.4728
satalt:
32438.3383
satid:
9956
satname:
COSMOS 886 DEB
intDesignator:
1976-126AW
launchDate:
1976-12-27
satlat:
53.6934
satlng:
19.2172
satalt:
2038.8512
satid:
10684
satname:
OPS 5111 (NAVSTAR 1)
intDesignator:
1978-020A
launchDate:
1978-02-22
satlat:
53.1811
satlng:
4.3984
satalt:
20612.0924
satid:
10751
satname:
DELTA 1 DEB
intDesignator:
1976-077AY
launchDate:
1976-07-29
satlat:
61.961
satlng:
8.3374
satalt:
1701.5385
satid:
11693
satname:
COSMOS 1158
intDesignator:
1980-012C
launchDate:
1980-02-11
satlat:
60.2365
satlng:
8.6578
satalt:
1467.0494
satid:
11909
satname:
SL-6 R/B(2)
intDesignator:
1980-063D
launchDate:
1980-07-18
satlat:
63.8911
satlng:
10.4967
satalt:
39407.5961
satid:
12078
satname:
COSMOS 1223
intDesignator:
1980-095A
launchDate:
1980-11-27
satlat:
48.6444
satlng:
-22.6173
satalt:
19137.8478
satid:
12748
satname:
COSMOS 1275 DEB
intDesignator:
1981-053CR
launchDate:
1981-06-04
satlat:
62.4417
satlng:
9.059
satalt:
1015.3713
satid:
13169
satname:
SL-6 R/B(2)
intDesignator:
1982-029D
launchDate:
1982-04-07
satlat:
58.0533
satlng:
26.9138
satalt:
33068.6931
satid:
14591
satname:
COSMOS 1520 (GLONASS)
intDesignator:
1983-127B
launchDate:
1983-12-29
satlat:
66.2825
satlng:
-34.3818
satalt:
19132.6971
satid:
14884
satname:
COSMOS 1547
intDesignator:
1984-033A
launchDate:
1984-04-04
satlat:
70.9762
satlng:
-4.1029
satalt:
27503.4451
satid:
15098
satname:
SL-6 R/B(2)
intDesignator:
1984-071D
launchDate:
1984-07-03
satlat:
69.6745
satlng:
37.3766
satalt:
34309.2066
satid:
15261
satname:
COSMOS 1595 (GLONASS)
intDesignator:
1984-095C
launchDate:
1984-09-04
satlat:
39.0235
satlng:
5.4349
satalt:
19256.8312
satid:
15429
satname:
MOLNIYA 1-63
intDesignator:
1984-124A
launchDate:
1984-12-14
satlat:
52.7358
satlng:
25.9494
satalt:
22887.6995
satid:
15439
satname:
SL-6 R/B(2)
intDesignator:
1984-124H
launchDate:
1984-12-14
satlat:
62.5506
satlng:
-12.1211
satalt:
37027.159
satid:
15715
satname:
SL-12 R/B(AUX MOTOR)
intDesignator:
1985-037H
launchDate:
1985-05-17
satlat:
52.1412
satlng:
18.9971
satalt:
3848.9174
satid:
16129
satname:
NAVSTAR 11 (USA 10)
intDesignator:
1985-093A
launchDate:
1985-10-09
satlat:
37.7808
satlng:
19.9288
satalt:
20290.6703
satid:
16396
satname:
COSMOS 1710 (GLONASS)
intDesignator:
1985-118A
launchDate:
1985-12-24
satlat:
55.9692
satlng:
15.1057
satalt:
19136.4142

limit:

offset:

returned:

has_more_results:

yes

next_offset:

Show all fields in HTML

info:

category:: ANY
transactionscount:: 15
satcount:: 139

above:

25 results

satid:
159
satname:
THOR ABLESTAR DEB
intDesignator:
1961-015AV
launchDate:
1961-06-29
satlat:
58.524
satlng:
17.6286
satalt:
988.0493
satid:
273
satname:
MIDAS 5 DEB
intDesignator:
1962-010C
launchDate:
1962-04-09
satlat:
53.8347
satlng:
10.8653
satalt:
2902.8752
satid:
746
satname:
ELEKTRON 1
intDesignator:
1964-006A
launchDate:
1964-01-30
satlat:
55.7426
satlng:
-3.8426
satalt:
6177.593
satid:
1459
satname:
OPS 6564 (VELA 6)
intDesignator:
1965-058B
launchDate:
1965-07-20
satlat:
40.7244
satlng:
-12.9656
satalt:
56606.1967
satid:
2700
satname:
DELTA 1 DEB
intDesignator:
1965-089C
launchDate:
1965-11-06
satlat:
57.738
satlng:
4.8949
satalt:
1462.5083
satid:
2802
satname:
SL-8 R/B
intDesignator:
1967-045B
launchDate:
1967-05-15
satlat:
59.634
satlng:
5.1142
satalt:
783.1976
satid:
7079
satname:
DELTA 1 DEB
intDesignator:
1973-086BX
launchDate:
1973-11-06
satlat:
57.857
satlng:
5.8168
satalt:
1563.5926
satid:
7276
satname:
MOLNIYA 2-9
intDesignator:
1974-026A
launchDate:
1974-04-26
satlat:
62.6629
satlng:
-15.4728
satalt:
32438.3383
satid:
9956
satname:
COSMOS 886 DEB
intDesignator:
1976-126AW
launchDate:
1976-12-27
satlat:
53.6934
satlng:
19.2172
satalt:
2038.8512
satid:
10684
satname:
OPS 5111 (NAVSTAR 1)
intDesignator:
1978-020A
launchDate:
1978-02-22
satlat:
53.1811
satlng:
4.3984
satalt:
20612.0924
satid:
10751
satname:
DELTA 1 DEB
intDesignator:
1976-077AY
launchDate:
1976-07-29
satlat:
61.961
satlng:
8.3374
satalt:
1701.5385
satid:
11693
satname:
COSMOS 1158
intDesignator:
1980-012C
launchDate:
1980-02-11
satlat:
60.2365
satlng:
8.6578
satalt:
1467.0494
satid:
11909
satname:
SL-6 R/B(2)
intDesignator:
1980-063D
launchDate:
1980-07-18
satlat:
63.8911
satlng:
10.4967
satalt:
39407.5961
satid:
12078
satname:
COSMOS 1223
intDesignator:
1980-095A
launchDate:
1980-11-27
satlat:
48.6444
satlng:
-22.6173
satalt:
19137.8478
satid:
12748
satname:
COSMOS 1275 DEB
intDesignator:
1981-053CR
launchDate:
1981-06-04
satlat:
62.4417
satlng:
9.059
satalt:
1015.3713
satid:
13169
satname:
SL-6 R/B(2)
intDesignator:
1982-029D
launchDate:
1982-04-07
satlat:
58.0533
satlng:
26.9138
satalt:
33068.6931
satid:
14591
satname:
COSMOS 1520 (GLONASS)
intDesignator:
1983-127B
launchDate:
1983-12-29
satlat:
66.2825
satlng:
-34.3818
satalt:
19132.6971
satid:
14884
satname:
COSMOS 1547
intDesignator:
1984-033A
launchDate:
1984-04-04
satlat:
70.9762
satlng:
-4.1029
satalt:
27503.4451
satid:
15098
satname:
SL-6 R/B(2)
intDesignator:
1984-071D
launchDate:
1984-07-03
satlat:
69.6745
satlng:
37.3766
satalt:
34309.2066
satid:
15261
satname:
COSMOS 1595 (GLONASS)
intDesignator:
1984-095C
launchDate:
1984-09-04
satlat:
39.0235
satlng:
5.4349
satalt:
19256.8312
satid:
15429
satname:
MOLNIYA 1-63
intDesignator:
1984-124A
launchDate:
1984-12-14
satlat:
52.7358
satlng:
25.9494
satalt:
22887.6995
satid:
15439
satname:
SL-6 R/B(2)
intDesignator:
1984-124H
launchDate:
1984-12-14
satlat:
62.5506
satlng:
-12.1211
satalt:
37027.159
satid:
15715
satname:
SL-12 R/B(AUX MOTOR)
intDesignator:
1985-037H
launchDate:
1985-05-17
satlat:
52.1412
satlng:
18.9971
satalt:
3848.9174
satid:
16129
satname:
NAVSTAR 11 (USA 10)
intDesignator:
1985-093A
launchDate:
1985-10-09
satlat:
37.7808
satlng:
19.9288
satalt:
20290.6703
satid:
16396
satname:
COSMOS 1710 (GLONASS)
intDesignator:
1985-118A
launchDate:
1985-12-24
satlat:
55.9692
satlng:
15.1057
satalt:
19136.4142

limit:

offset:

returned:

has_more_results:

yes

next_offset:

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.