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-24T23:50:33Z in 0.961 seconds.

info:

category:: ANY
transactionscount:: 93
satcount:: 117

above:

25 results

satid:
4777
satname:
THORAD AGENA D DEB
intDesignator:
1970-025DX
launchDate:
1970-04-08
satlat:
63.4185
satlng:
6.8674
satalt:
935.9928
satid:
6192
satname:
COSMOS 520
intDesignator:
1972-072A
launchDate:
1972-09-19
satlat:
49.4279
satlng:
17.7362
satalt:
8919.9534
satid:
6675
satname:
COSMOS 564
intDesignator:
1973-037A
launchDate:
1973-06-08
satlat:
62.1569
satlng:
8.699
satalt:
1436.4251
satid:
7168
satname:
DELTA 1 DEB
intDesignator:
1973-086EG
launchDate:
1973-11-06
satlat:
69.0368
satlng:
0.507
satalt:
1703.6208
satid:
7192
satname:
DELTA 1 DEB
intDesignator:
1973-086FA
launchDate:
1973-11-06
satlat:
61.8211
satlng:
6.877
satalt:
1534.0779
satid:
7268
satname:
COSMOS 644
intDesignator:
1974-024D
launchDate:
1974-04-23
satlat:
65.0274
satlng:
19.3992
satalt:
1353.3
satid:
7373
satname:
SL-6 R/B(2)
intDesignator:
1974-026E
launchDate:
1974-04-26
satlat:
57.1524
satlng:
50.5716
satalt:
31092.7933
satid:
7629
satname:
SL-6 R/B(2)
intDesignator:
1975-007D
launchDate:
1975-01-30
satlat:
41.8413
satlng:
25.6375
satalt:
32426.4699
satid:
8295
satname:
SL-8 R/B
intDesignator:
1975-086J
launchDate:
1975-09-17
satlat:
63.82
satlng:
14.0146
satalt:
1547.9443
satid:
8893
satname:
COSMOS 829
intDesignator:
1976-054E
launchDate:
1976-06-15
satlat:
60.7424
satlng:
-0.2673
satalt:
1480.8254
satid:
9013
satname:
SL-8 R/B
intDesignator:
1976-067B
launchDate:
1976-07-08
satlat:
65.9435
satlng:
-3.865
satalt:
1580.8322
satid:
9061
satname:
COSMOS 846
intDesignator:
1976-078A
launchDate:
1976-07-29
satlat:
64.3109
satlng:
-0.1924
satalt:
1015.5042
satid:
9701
satname:
DELTA 1 DEB
intDesignator:
1973-086FZ
launchDate:
1973-11-06
satlat:
61.5245
satlng:
17.4425
satalt:
1130.2179
satid:
10893
satname:
OPS 5112 (NAVSTAR 2)
intDesignator:
1978-047A
launchDate:
1978-05-13
satlat:
60.7407
satlng:
19.9453
satalt:
19302.5841
satid:
12326
satname:
COSMOS 1256
intDesignator:
1981-022G
launchDate:
1981-03-06
satlat:
64.3586
satlng:
-2.3063
satalt:
1479.4944
satid:
12329
satname:
KYOKKO 1 DEB
intDesignator:
1978-014C
launchDate:
1978-02-04
satlat:
64.917
satlng:
2.5809
satalt:
1988.048
satid:
12406
satname:
KYOKKO 1 DEB
intDesignator:
1978-014F
launchDate:
1978-02-04
satlat:
58.2577
satlng:
-6.1197
satalt:
3019.3659
satid:
12728
satname:
COSMOS 1275 DEB
intDesignator:
1981-053BV
launchDate:
1981-06-04
satlat:
61.6307
satlng:
16.3888
satalt:
1009.5081
satid:
12942
satname:
COSMOS 970 DEB
intDesignator:
1977-121AZ
launchDate:
1977-12-21
satlat:
65.2641
satlng:
2.1203
satalt:
1114.5463
satid:
12979
satname:
COSMOS 1324
intDesignator:
1981-116E
launchDate:
1981-11-28
satlat:
58.5985
satlng:
16.1909
satalt:
1523.8476
satid:
13169
satname:
SL-6 R/B(2)
intDesignator:
1982-029D
launchDate:
1982-04-07
satlat:
71.9573
satlng:
45.6526
satalt:
25502.0188
satid:
14591
satname:
COSMOS 1520 (GLONASS)
intDesignator:
1983-127B
launchDate:
1983-12-29
satlat:
66.3853
satlng:
57.0726
satalt:
19129.2397
satid:
15098
satname:
SL-6 R/B(2)
intDesignator:
1984-071D
launchDate:
1984-07-03
satlat:
70.8968
satlng:
56.7311
satalt:
31980.2458
satid:
15223
satname:
SL-6 R/B(2)
intDesignator:
1984-089D
launchDate:
1984-08-24
satlat:
58.7172
satlng:
2.3222
satalt:
38290.3139
satid:
15271
satname:
NAVSTAR 10 (USA 5)
intDesignator:
1984-097A
launchDate:
1984-09-08
satlat:
61.0654
satlng:
32.9981
satalt:
21170.4532

limit:

offset:

returned:

has_more_results:

yes

truncated:

yes

next_offset:

Show all fields in HTML

info:

category:: ANY
transactionscount:: 93
satcount:: 117

above:

25 results

satid:
4777
satname:
THORAD AGENA D DEB
intDesignator:
1970-025DX
launchDate:
1970-04-08
satlat:
63.4185
satlng:
6.8674
satalt:
935.9928
satid:
6192
satname:
COSMOS 520
intDesignator:
1972-072A
launchDate:
1972-09-19
satlat:
49.4279
satlng:
17.7362
satalt:
8919.9534
satid:
6675
satname:
COSMOS 564
intDesignator:
1973-037A
launchDate:
1973-06-08
satlat:
62.1569
satlng:
8.699
satalt:
1436.4251
satid:
7168
satname:
DELTA 1 DEB
intDesignator:
1973-086EG
launchDate:
1973-11-06
satlat:
69.0368
satlng:
0.507
satalt:
1703.6208
satid:
7192
satname:
DELTA 1 DEB
intDesignator:
1973-086FA
launchDate:
1973-11-06
satlat:
61.8211
satlng:
6.877
satalt:
1534.0779
satid:
7268
satname:
COSMOS 644
intDesignator:
1974-024D
launchDate:
1974-04-23
satlat:
65.0274
satlng:
19.3992
satalt:
1353.3
satid:
7373
satname:
SL-6 R/B(2)
intDesignator:
1974-026E
launchDate:
1974-04-26
satlat:
57.1524
satlng:
50.5716
satalt:
31092.7933
satid:
7629
satname:
SL-6 R/B(2)
intDesignator:
1975-007D
launchDate:
1975-01-30
satlat:
41.8413
satlng:
25.6375
satalt:
32426.4699
satid:
8295
satname:
SL-8 R/B
intDesignator:
1975-086J
launchDate:
1975-09-17
satlat:
63.82
satlng:
14.0146
satalt:
1547.9443
satid:
8893
satname:
COSMOS 829
intDesignator:
1976-054E
launchDate:
1976-06-15
satlat:
60.7424
satlng:
-0.2673
satalt:
1480.8254
satid:
9013
satname:
SL-8 R/B
intDesignator:
1976-067B
launchDate:
1976-07-08
satlat:
65.9435
satlng:
-3.865
satalt:
1580.8322
satid:
9061
satname:
COSMOS 846
intDesignator:
1976-078A
launchDate:
1976-07-29
satlat:
64.3109
satlng:
-0.1924
satalt:
1015.5042
satid:
9701
satname:
DELTA 1 DEB
intDesignator:
1973-086FZ
launchDate:
1973-11-06
satlat:
61.5245
satlng:
17.4425
satalt:
1130.2179
satid:
10893
satname:
OPS 5112 (NAVSTAR 2)
intDesignator:
1978-047A
launchDate:
1978-05-13
satlat:
60.7407
satlng:
19.9453
satalt:
19302.5841
satid:
12326
satname:
COSMOS 1256
intDesignator:
1981-022G
launchDate:
1981-03-06
satlat:
64.3586
satlng:
-2.3063
satalt:
1479.4944
satid:
12329
satname:
KYOKKO 1 DEB
intDesignator:
1978-014C
launchDate:
1978-02-04
satlat:
64.917
satlng:
2.5809
satalt:
1988.048
satid:
12406
satname:
KYOKKO 1 DEB
intDesignator:
1978-014F
launchDate:
1978-02-04
satlat:
58.2577
satlng:
-6.1197
satalt:
3019.3659
satid:
12728
satname:
COSMOS 1275 DEB
intDesignator:
1981-053BV
launchDate:
1981-06-04
satlat:
61.6307
satlng:
16.3888
satalt:
1009.5081
satid:
12942
satname:
COSMOS 970 DEB
intDesignator:
1977-121AZ
launchDate:
1977-12-21
satlat:
65.2641
satlng:
2.1203
satalt:
1114.5463
satid:
12979
satname:
COSMOS 1324
intDesignator:
1981-116E
launchDate:
1981-11-28
satlat:
58.5985
satlng:
16.1909
satalt:
1523.8476
satid:
13169
satname:
SL-6 R/B(2)
intDesignator:
1982-029D
launchDate:
1982-04-07
satlat:
71.9573
satlng:
45.6526
satalt:
25502.0188
satid:
14591
satname:
COSMOS 1520 (GLONASS)
intDesignator:
1983-127B
launchDate:
1983-12-29
satlat:
66.3853
satlng:
57.0726
satalt:
19129.2397
satid:
15098
satname:
SL-6 R/B(2)
intDesignator:
1984-071D
launchDate:
1984-07-03
satlat:
70.8968
satlng:
56.7311
satalt:
31980.2458
satid:
15223
satname:
SL-6 R/B(2)
intDesignator:
1984-089D
launchDate:
1984-08-24
satlat:
58.7172
satlng:
2.3222
satalt:
38290.3139
satid:
15271
satname:
NAVSTAR 10 (USA 5)
intDesignator:
1984-097A
launchDate:
1984-09-08
satlat:
61.0654
satlng:
32.9981
satalt:
21170.4532

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.