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-09-27T08:06:06Z in 0.988 seconds.

info:

category:: ANY
transactionscount:: 64
satcount:: 122

above:

25 results

satid:
1502
satname:
SCOUT B R/B
intDesignator:
1965-063B
launchDate:
1965-08-10
satlat:
58.5904
satlng:
10.0044
satalt:
1200.8075
satid:
3557
satname:
COSMOS 252 DEB
intDesignator:
1968-097K
launchDate:
1968-11-01
satlat:
57.1849
satlng:
-6.5251
satalt:
1764.2909
satid:
6197
satname:
EXPLORER 47 (IMP-7)
intDesignator:
1972-073A
launchDate:
1972-09-23
satlat:
59.0489
satlng:
-8.3011
satalt:
228610.6907
satid:
7028
satname:
DELTA 1 DEB
intDesignator:
1973-086U
launchDate:
1973-11-06
satlat:
64.624
satlng:
9.8341
satalt:
1648.1496
satid:
7276
satname:
MOLNIYA 2-9
intDesignator:
1974-026A
launchDate:
1974-04-26
satlat:
55.1364
satlng:
12.1483
satalt:
22978.4704
satid:
8292
satname:
COSMOS 768
intDesignator:
1975-086H
launchDate:
1975-09-17
satlat:
55.4371
satlng:
6.6747
satalt:
1480.4992
satid:
8307
satname:
THORAD DELTA 1 DEB
intDesignator:
1974-089BQ
launchDate:
1974-11-15
satlat:
56.6516
satlng:
8.7693
satalt:
1431.2734
satid:
9895
satname:
COSMOS 862 DEB
intDesignator:
1976-105M
launchDate:
1976-10-22
satlat:
62.4025
satlng:
11.7687
satalt:
20688.9477
satid:
10445
satname:
COSMOS 839 DEB
intDesignator:
1976-067W
launchDate:
1976-07-08
satlat:
65.1902
satlng:
-0.871
satalt:
2166.7583
satid:
11142
satname:
ATLAS F R/B
intDesignator:
1978-112B
launchDate:
1978-12-11
satlat:
61.6603
satlng:
27.8785
satalt:
13481.4155
satid:
11847
satname:
SL-6 R/B(2)
intDesignator:
1980-050B
launchDate:
1980-06-14
satlat:
67.8802
satlng:
-23.8303
satalt:
27661.1254
satid:
12078
satname:
COSMOS 1223
intDesignator:
1980-095A
launchDate:
1980-11-27
satlat:
70.2934
satlng:
38.87
satalt:
31061.2071
satid:
12680
satname:
SL-6 R/B(2)
intDesignator:
1981-071D
launchDate:
1981-08-04
satlat:
64.0853
satlng:
33.9097
satalt:
8021.7429
satid:
13001
satname:
RADIO 7
intDesignator:
1981-120E
launchDate:
1981-12-17
satlat:
54.3019
satlng:
9.6016
satalt:
1632.9199
satid:
13075
satname:
SL-6 R/B(2)
intDesignator:
1982-015D
launchDate:
1982-02-26
satlat:
58.2823
satlng:
21.3602
satalt:
30798.281
satid:
13080
satname:
COSMOS 1341
intDesignator:
1982-016A
launchDate:
1982-03-03
satlat:
65.7195
satlng:
2.3439
satalt:
33052.9373
satid:
13462
satname:
COSMOS 1275 DEB
intDesignator:
1981-053FJ
launchDate:
1981-06-04
satlat:
58.8277
satlng:
9.5722
satalt:
1112.2501
satid:
13498
satname:
SL-8 DEB *
intDesignator:
1981-041C
launchDate:
1981-05-07
satlat:
59.4119
satlng:
0.6714
satalt:
664.476
satid:
13575
satname:
DELTA 1 DEB
intDesignator:
1978-026FN
launchDate:
1978-03-05
satlat:
56.2037
satlng:
2.9939
satalt:
870.4768
satid:
13610
satname:
SL-12 R/B(2)
intDesignator:
1982-100H
launchDate:
1982-10-12
satlat:
55.5365
satlng:
-22.6218
satalt:
19080.6442
satid:
13908
satname:
SL-6 DEB
intDesignator:
1981-088H
launchDate:
1981-09-11
satlat:
61.9349
satlng:
42.3949
satalt:
12138.4598
satid:
14189
satname:
OPS 9794 (NAVSTAR 8)
intDesignator:
1983-072A
launchDate:
1983-07-14
satlat:
61.0917
satlng:
2.6745
satalt:
20426.6597
satid:
15226
satname:
USA 4
intDesignator:
1984-091A
launchDate:
1984-08-28
satlat:
58.3261
satlng:
2.2453
satalt:
28344.9867
satid:
15619
satname:
COSMOS 1637
intDesignator:
1985-023C
launchDate:
1985-03-21
satlat:
53.0806
satlng:
4.7221
satalt:
1473.3941
satid:
16396
satname:
COSMOS 1710 (GLONASS)
intDesignator:
1985-118A
launchDate:
1985-12-24
satlat:
54.8414
satlng:
-25.9344
satalt:
19134.7298

limit:

offset:

returned:

has_more_results:

yes

truncated:

yes

next_offset:

Show all fields in HTML

info:

category:: ANY
transactionscount:: 64
satcount:: 122

above:

25 results

satid:
1502
satname:
SCOUT B R/B
intDesignator:
1965-063B
launchDate:
1965-08-10
satlat:
58.5904
satlng:
10.0044
satalt:
1200.8075
satid:
3557
satname:
COSMOS 252 DEB
intDesignator:
1968-097K
launchDate:
1968-11-01
satlat:
57.1849
satlng:
-6.5251
satalt:
1764.2909
satid:
6197
satname:
EXPLORER 47 (IMP-7)
intDesignator:
1972-073A
launchDate:
1972-09-23
satlat:
59.0489
satlng:
-8.3011
satalt:
228610.6907
satid:
7028
satname:
DELTA 1 DEB
intDesignator:
1973-086U
launchDate:
1973-11-06
satlat:
64.624
satlng:
9.8341
satalt:
1648.1496
satid:
7276
satname:
MOLNIYA 2-9
intDesignator:
1974-026A
launchDate:
1974-04-26
satlat:
55.1364
satlng:
12.1483
satalt:
22978.4704
satid:
8292
satname:
COSMOS 768
intDesignator:
1975-086H
launchDate:
1975-09-17
satlat:
55.4371
satlng:
6.6747
satalt:
1480.4992
satid:
8307
satname:
THORAD DELTA 1 DEB
intDesignator:
1974-089BQ
launchDate:
1974-11-15
satlat:
56.6516
satlng:
8.7693
satalt:
1431.2734
satid:
9895
satname:
COSMOS 862 DEB
intDesignator:
1976-105M
launchDate:
1976-10-22
satlat:
62.4025
satlng:
11.7687
satalt:
20688.9477
satid:
10445
satname:
COSMOS 839 DEB
intDesignator:
1976-067W
launchDate:
1976-07-08
satlat:
65.1902
satlng:
-0.871
satalt:
2166.7583
satid:
11142
satname:
ATLAS F R/B
intDesignator:
1978-112B
launchDate:
1978-12-11
satlat:
61.6603
satlng:
27.8785
satalt:
13481.4155
satid:
11847
satname:
SL-6 R/B(2)
intDesignator:
1980-050B
launchDate:
1980-06-14
satlat:
67.8802
satlng:
-23.8303
satalt:
27661.1254
satid:
12078
satname:
COSMOS 1223
intDesignator:
1980-095A
launchDate:
1980-11-27
satlat:
70.2934
satlng:
38.87
satalt:
31061.2071
satid:
12680
satname:
SL-6 R/B(2)
intDesignator:
1981-071D
launchDate:
1981-08-04
satlat:
64.0853
satlng:
33.9097
satalt:
8021.7429
satid:
13001
satname:
RADIO 7
intDesignator:
1981-120E
launchDate:
1981-12-17
satlat:
54.3019
satlng:
9.6016
satalt:
1632.9199
satid:
13075
satname:
SL-6 R/B(2)
intDesignator:
1982-015D
launchDate:
1982-02-26
satlat:
58.2823
satlng:
21.3602
satalt:
30798.281
satid:
13080
satname:
COSMOS 1341
intDesignator:
1982-016A
launchDate:
1982-03-03
satlat:
65.7195
satlng:
2.3439
satalt:
33052.9373
satid:
13462
satname:
COSMOS 1275 DEB
intDesignator:
1981-053FJ
launchDate:
1981-06-04
satlat:
58.8277
satlng:
9.5722
satalt:
1112.2501
satid:
13498
satname:
SL-8 DEB *
intDesignator:
1981-041C
launchDate:
1981-05-07
satlat:
59.4119
satlng:
0.6714
satalt:
664.476
satid:
13575
satname:
DELTA 1 DEB
intDesignator:
1978-026FN
launchDate:
1978-03-05
satlat:
56.2037
satlng:
2.9939
satalt:
870.4768
satid:
13610
satname:
SL-12 R/B(2)
intDesignator:
1982-100H
launchDate:
1982-10-12
satlat:
55.5365
satlng:
-22.6218
satalt:
19080.6442
satid:
13908
satname:
SL-6 DEB
intDesignator:
1981-088H
launchDate:
1981-09-11
satlat:
61.9349
satlng:
42.3949
satalt:
12138.4598
satid:
14189
satname:
OPS 9794 (NAVSTAR 8)
intDesignator:
1983-072A
launchDate:
1983-07-14
satlat:
61.0917
satlng:
2.6745
satalt:
20426.6597
satid:
15226
satname:
USA 4
intDesignator:
1984-091A
launchDate:
1984-08-28
satlat:
58.3261
satlng:
2.2453
satalt:
28344.9867
satid:
15619
satname:
COSMOS 1637
intDesignator:
1985-023C
launchDate:
1985-03-21
satlat:
53.0806
satlng:
4.7221
satalt:
1473.3941
satid:
16396
satname:
COSMOS 1710 (GLONASS)
intDesignator:
1985-118A
launchDate:
1985-12-24
satlat:
54.8414
satlng:
-25.9344
satalt:
19134.7298

limit:

offset:

returned:

has_more_results:

yes

truncated:

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.