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-23T09:08:33Z in 0.917 seconds.

info:

category:: ANY
transactionscount:: 87
satcount:: 115

above:

25 results

satid:
837
satname:
OPS 3674 (VELA 4)
intDesignator:
1964-040B
launchDate:
1964-07-17
satlat:
45.5593
satlng:
43.5449
satalt:
174495.5046
satid:
1506
satname:
SECOR 5 (EGRS 5)
intDesignator:
1965-063A
launchDate:
1965-08-10
satlat:
65.4784
satlng:
16.1088
satalt:
1153.7908
satid:
2256
satname:
PAGEOS 1 DEB
intDesignator:
1966-056C
launchDate:
1966-06-24
satlat:
68.0747
satlng:
18.6941
satalt:
4214.4394
satid:
2378
satname:
WESTFORD NEEDLES
intDesignator:
1963-014Y
launchDate:
1963-05-09
satlat:
66.8261
satlng:
15.8527
satalt:
3361.3884
satid:
2861
satname:
SECOR 9 (EGRS 9)
intDesignator:
1967-065A
launchDate:
1967-06-29
satlat:
64.2908
satlng:
-5.4222
satalt:
3901.4947
satid:
3790
satname:
COSMOS 249 DEB *
intDesignator:
1968-091AX
launchDate:
1968-10-20
satlat:
62.9128
satlng:
11.2175
satalt:
1424.4772
satid:
4784
satname:
SL-8 R/B
intDesignator:
1970-102B
launchDate:
1970-12-02
satlat:
65.9502
satlng:
10.2833
satalt:
969.482
satid:
5098
satname:
COSMOS 397 DEB
intDesignator:
1971-015X
launchDate:
1971-02-25
satlat:
65.1032
satlng:
5.1179
satalt:
1622.8541
satid:
7437
satname:
COSMOS 679
intDesignator:
1974-072C
launchDate:
1974-09-19
satlat:
63.4463
satlng:
-2.3435
satalt:
1479.1594
satid:
8599
satname:
NTS 1 AKM
intDesignator:
1974-054C
launchDate:
1974-07-14
satlat:
53.403
satlng:
1.8401
satalt:
13515.8028
satid:
8601
satname:
MOLNIYA 1-32
intDesignator:
1976-006A
launchDate:
1976-01-22
satlat:
44.9131
satlng:
15.3529
satalt:
21917.1504
satid:
9816
satname:
COSMOS 886 DEB
intDesignator:
1976-126AC
launchDate:
1976-12-27
satlat:
64.8604
satlng:
16.3815
satalt:
1102.5863
satid:
11142
satname:
ATLAS F R/B
intDesignator:
1978-112B
launchDate:
1978-12-11
satlat:
47.4161
satlng:
-13.6041
satalt:
13580.0422
satid:
11847
satname:
SL-6 R/B(2)
intDesignator:
1980-050B
launchDate:
1980-06-14
satlat:
60.0381
satlng:
-5.9198
satalt:
33947.9306
satid:
11909
satname:
SL-6 R/B(2)
intDesignator:
1980-063D
launchDate:
1980-07-18
satlat:
62.194
satlng:
-21.9302
satalt:
40097.3608
satid:
12078
satname:
COSMOS 1223
intDesignator:
1980-095A
launchDate:
1980-11-27
satlat:
63.9932
satlng:
45.6579
satalt:
32259.5817
satid:
12759
satname:
COSMOS 1275 DEB
intDesignator:
1981-053DC
launchDate:
1981-06-04
satlat:
62.6192
satlng:
3.6209
satalt:
914.4301
satid:
13016
satname:
SL-6 R/B(2)
intDesignator:
1981-123D
launchDate:
1981-12-23
satlat:
58.5031
satlng:
-26.4675
satalt:
33907.2821
satid:
13075
satname:
SL-6 R/B(2)
intDesignator:
1982-015D
launchDate:
1982-02-26
satlat:
63.127
satlng:
44.0204
satalt:
38385.6052
satid:
13080
satname:
COSMOS 1341
intDesignator:
1982-016A
launchDate:
1982-03-03
satlat:
60.448
satlng:
1.827
satalt:
34536.6993
satid:
13607
satname:
COSMOS 1415 (GLONASS)
intDesignator:
1982-100E
launchDate:
1982-10-12
satlat:
59.4231
satlng:
51.7356
satalt:
19079.9501
satid:
13875
satname:
MOLNIYA 3-20
intDesignator:
1983-015A
launchDate:
1983-03-11
satlat:
57.2832
satlng:
49.4984
satalt:
33089.0118
satid:
13910
satname:
SL-6 DEB
intDesignator:
1981-088K
launchDate:
1981-09-11
satlat:
62.7888
satlng:
-32.4659
satalt:
10468.2559
satid:
13961
satname:
COSMOS 1285 DEB
intDesignator:
1981-071F
launchDate:
1981-08-04
satlat:
70.8114
satlng:
27.2805
satalt:
18700.2002
satid:
14238
satname:
TITAN 34B AGENA D R/B
intDesignator:
1983-078B
launchDate:
1983-07-31
satlat:
57.7021
satlng:
56.3001
satalt:
28226.0681

limit:

offset:

returned:

has_more_results:

yes

truncated:

yes

next_offset:

Show all fields in HTML

info:

category:: ANY
transactionscount:: 87
satcount:: 115

above:

25 results

satid:
837
satname:
OPS 3674 (VELA 4)
intDesignator:
1964-040B
launchDate:
1964-07-17
satlat:
45.5593
satlng:
43.5449
satalt:
174495.5046
satid:
1506
satname:
SECOR 5 (EGRS 5)
intDesignator:
1965-063A
launchDate:
1965-08-10
satlat:
65.4784
satlng:
16.1088
satalt:
1153.7908
satid:
2256
satname:
PAGEOS 1 DEB
intDesignator:
1966-056C
launchDate:
1966-06-24
satlat:
68.0747
satlng:
18.6941
satalt:
4214.4394
satid:
2378
satname:
WESTFORD NEEDLES
intDesignator:
1963-014Y
launchDate:
1963-05-09
satlat:
66.8261
satlng:
15.8527
satalt:
3361.3884
satid:
2861
satname:
SECOR 9 (EGRS 9)
intDesignator:
1967-065A
launchDate:
1967-06-29
satlat:
64.2908
satlng:
-5.4222
satalt:
3901.4947
satid:
3790
satname:
COSMOS 249 DEB *
intDesignator:
1968-091AX
launchDate:
1968-10-20
satlat:
62.9128
satlng:
11.2175
satalt:
1424.4772
satid:
4784
satname:
SL-8 R/B
intDesignator:
1970-102B
launchDate:
1970-12-02
satlat:
65.9502
satlng:
10.2833
satalt:
969.482
satid:
5098
satname:
COSMOS 397 DEB
intDesignator:
1971-015X
launchDate:
1971-02-25
satlat:
65.1032
satlng:
5.1179
satalt:
1622.8541
satid:
7437
satname:
COSMOS 679
intDesignator:
1974-072C
launchDate:
1974-09-19
satlat:
63.4463
satlng:
-2.3435
satalt:
1479.1594
satid:
8599
satname:
NTS 1 AKM
intDesignator:
1974-054C
launchDate:
1974-07-14
satlat:
53.403
satlng:
1.8401
satalt:
13515.8028
satid:
8601
satname:
MOLNIYA 1-32
intDesignator:
1976-006A
launchDate:
1976-01-22
satlat:
44.9131
satlng:
15.3529
satalt:
21917.1504
satid:
9816
satname:
COSMOS 886 DEB
intDesignator:
1976-126AC
launchDate:
1976-12-27
satlat:
64.8604
satlng:
16.3815
satalt:
1102.5863
satid:
11142
satname:
ATLAS F R/B
intDesignator:
1978-112B
launchDate:
1978-12-11
satlat:
47.4161
satlng:
-13.6041
satalt:
13580.0422
satid:
11847
satname:
SL-6 R/B(2)
intDesignator:
1980-050B
launchDate:
1980-06-14
satlat:
60.0381
satlng:
-5.9198
satalt:
33947.9306
satid:
11909
satname:
SL-6 R/B(2)
intDesignator:
1980-063D
launchDate:
1980-07-18
satlat:
62.194
satlng:
-21.9302
satalt:
40097.3608
satid:
12078
satname:
COSMOS 1223
intDesignator:
1980-095A
launchDate:
1980-11-27
satlat:
63.9932
satlng:
45.6579
satalt:
32259.5817
satid:
12759
satname:
COSMOS 1275 DEB
intDesignator:
1981-053DC
launchDate:
1981-06-04
satlat:
62.6192
satlng:
3.6209
satalt:
914.4301
satid:
13016
satname:
SL-6 R/B(2)
intDesignator:
1981-123D
launchDate:
1981-12-23
satlat:
58.5031
satlng:
-26.4675
satalt:
33907.2821
satid:
13075
satname:
SL-6 R/B(2)
intDesignator:
1982-015D
launchDate:
1982-02-26
satlat:
63.127
satlng:
44.0204
satalt:
38385.6052
satid:
13080
satname:
COSMOS 1341
intDesignator:
1982-016A
launchDate:
1982-03-03
satlat:
60.448
satlng:
1.827
satalt:
34536.6993
satid:
13607
satname:
COSMOS 1415 (GLONASS)
intDesignator:
1982-100E
launchDate:
1982-10-12
satlat:
59.4231
satlng:
51.7356
satalt:
19079.9501
satid:
13875
satname:
MOLNIYA 3-20
intDesignator:
1983-015A
launchDate:
1983-03-11
satlat:
57.2832
satlng:
49.4984
satalt:
33089.0118
satid:
13910
satname:
SL-6 DEB
intDesignator:
1981-088K
launchDate:
1981-09-11
satlat:
62.7888
satlng:
-32.4659
satalt:
10468.2559
satid:
13961
satname:
COSMOS 1285 DEB
intDesignator:
1981-071F
launchDate:
1981-08-04
satlat:
70.8114
satlng:
27.2805
satalt:
18700.2002
satid:
14238
satname:
TITAN 34B AGENA D R/B
intDesignator:
1983-078B
launchDate:
1983-07-31
satlat:
57.7021
satlng:
56.3001
satalt:
28226.0681

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.