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-17T12:13:50Z in 2.125 seconds.

info:

category:: ANY
transactionscount:: 32
satcount:: 128

above:

25 results

satid:
148
satname:
THOR ABLESTAR DEB
intDesignator:
1961-015AJ
launchDate:
1961-06-29
satlat:
63.9574
satlng:
9.1709
satalt:
975.8378
satid:
467
satname:
THOR ABLESTAR DEB
intDesignator:
1961-015FD
launchDate:
1961-06-29
satlat:
63.5021
satlng:
13.0103
satalt:
1229.6695
satid:
836
satname:
OPS 3662 (VELA 3)
intDesignator:
1964-040A
launchDate:
1964-07-17
satlat:
52.7551
satlng:
-13.7539
satalt:
161230.7201
satid:
1512
satname:
TEMPSAT 1
intDesignator:
1965-065E
launchDate:
1965-08-13
satlat:
61.8848
satlng:
3.1536
satalt:
1190.5515
satid:
5240
satname:
COSMOS 374 DEB
intDesignator:
1970-089BF
launchDate:
1970-10-23
satlat:
59.4327
satlng:
-3.7882
satalt:
1965.5707
satid:
5387
satname:
THORAD AGENA D DEB *
intDesignator:
1970-025KS
launchDate:
1970-04-08
satlat:
60.909
satlng:
6.0539
satalt:
1067.7749
satid:
6677
satname:
COSMOS 566
intDesignator:
1973-037C
launchDate:
1973-06-08
satlat:
58.0049
satlng:
14.6054
satalt:
1491.6556
satid:
7800
satname:
SL-6 R/B(2)
intDesignator:
1975-036D
launchDate:
1975-04-29
satlat:
61.5533
satlng:
37.2212
satalt:
38520.5729
satid:
8144
satname:
THORAD DELTA 1 DEB
intDesignator:
1974-089N
launchDate:
1974-11-15
satlat:
58.1188
satlng:
12.6614
satalt:
1452.6437
satid:
8601
satname:
MOLNIYA 1-32
intDesignator:
1976-006A
launchDate:
1976-01-22
satlat:
63.6915
satlng:
1.0559
satalt:
37692.8988
satid:
9822
satname:
COSMOS 886 DEB
intDesignator:
1976-126AJ
launchDate:
1976-12-27
satlat:
63.7362
satlng:
2.4426
satalt:
729.1316
satid:
10150
satname:
COSMOS 931
intDesignator:
1977-068A
launchDate:
1977-07-20
satlat:
44.5789
satlng:
1.0768
satalt:
33930.709
satid:
10646
satname:
DELTA 1 DEB
intDesignator:
1976-077G
launchDate:
1976-07-29
satlat:
59.8713
satlng:
8.8108
satalt:
1630.465
satid:
10730
satname:
DELTA 1 DEB
intDesignator:
1975-027E
launchDate:
1975-04-09
satlat:
60.7378
satlng:
-3.9179
satalt:
974.338
satid:
10936
satname:
COSMOS 1019
intDesignator:
1978-056G
launchDate:
1978-06-07
satlat:
57.6728
satlng:
11.4132
satalt:
1433.2053
satid:
12833
satname:
COSMOS 1109 DEB
intDesignator:
1979-058E
launchDate:
1979-06-27
satlat:
72.6522
satlng:
47.046
satalt:
20156.1243
satid:
12998
satname:
RADIO 8
intDesignator:
1981-120B
launchDate:
1981-12-17
satlat:
64.613
satlng:
10.1872
satalt:
1684.4456
satid:
13298
satname:
SL-6 R/B(2)
intDesignator:
1982-064D
launchDate:
1982-06-25
satlat:
44.439
satlng:
14.2871
satalt:
18697.456
satid:
13610
satname:
SL-12 R/B(2)
intDesignator:
1982-100H
launchDate:
1982-10-12
satlat:
46.9228
satlng:
2.1065
satalt:
19060.8574
satid:
13897
satname:
SL-6 R/B(2)
intDesignator:
1983-019D
launchDate:
1983-03-16
satlat:
62.0968
satlng:
55.2494
satalt:
36551.9684
satid:
14059
satname:
SL-8 R/B
intDesignator:
1983-042B
launchDate:
1983-05-06
satlat:
61.3961
satlng:
7.9781
satalt:
965.5786
satid:
14238
satname:
TITAN 34B AGENA D R/B
intDesignator:
1983-078B
launchDate:
1983-07-31
satlat:
49.916
satlng:
-3.1061
satalt:
23649.6508
satid:
15214
satname:
MOLNIYA 1-62
intDesignator:
1984-089A
launchDate:
1984-08-24
satlat:
60.6844
satlng:
-42.9051
satalt:
29282.4069
satid:
15226
satname:
USA 4
intDesignator:
1984-091A
launchDate:
1984-08-28
satlat:
45.6749
satlng:
12.6223
satalt:
31412.6631
satid:
15264
satname:
SL-12 R/B(2)
intDesignator:
1984-095F
launchDate:
1984-09-04
satlat:
55.7747
satlng:
-5.0016
satalt:
19123.6701

limit:

offset:

returned:

has_more_results:

yes

next_offset:

Show all fields in HTML

info:

category:: ANY
transactionscount:: 32
satcount:: 128

above:

25 results

satid:
148
satname:
THOR ABLESTAR DEB
intDesignator:
1961-015AJ
launchDate:
1961-06-29
satlat:
63.9574
satlng:
9.1709
satalt:
975.8378
satid:
467
satname:
THOR ABLESTAR DEB
intDesignator:
1961-015FD
launchDate:
1961-06-29
satlat:
63.5021
satlng:
13.0103
satalt:
1229.6695
satid:
836
satname:
OPS 3662 (VELA 3)
intDesignator:
1964-040A
launchDate:
1964-07-17
satlat:
52.7551
satlng:
-13.7539
satalt:
161230.7201
satid:
1512
satname:
TEMPSAT 1
intDesignator:
1965-065E
launchDate:
1965-08-13
satlat:
61.8848
satlng:
3.1536
satalt:
1190.5515
satid:
5240
satname:
COSMOS 374 DEB
intDesignator:
1970-089BF
launchDate:
1970-10-23
satlat:
59.4327
satlng:
-3.7882
satalt:
1965.5707
satid:
5387
satname:
THORAD AGENA D DEB *
intDesignator:
1970-025KS
launchDate:
1970-04-08
satlat:
60.909
satlng:
6.0539
satalt:
1067.7749
satid:
6677
satname:
COSMOS 566
intDesignator:
1973-037C
launchDate:
1973-06-08
satlat:
58.0049
satlng:
14.6054
satalt:
1491.6556
satid:
7800
satname:
SL-6 R/B(2)
intDesignator:
1975-036D
launchDate:
1975-04-29
satlat:
61.5533
satlng:
37.2212
satalt:
38520.5729
satid:
8144
satname:
THORAD DELTA 1 DEB
intDesignator:
1974-089N
launchDate:
1974-11-15
satlat:
58.1188
satlng:
12.6614
satalt:
1452.6437
satid:
8601
satname:
MOLNIYA 1-32
intDesignator:
1976-006A
launchDate:
1976-01-22
satlat:
63.6915
satlng:
1.0559
satalt:
37692.8988
satid:
9822
satname:
COSMOS 886 DEB
intDesignator:
1976-126AJ
launchDate:
1976-12-27
satlat:
63.7362
satlng:
2.4426
satalt:
729.1316
satid:
10150
satname:
COSMOS 931
intDesignator:
1977-068A
launchDate:
1977-07-20
satlat:
44.5789
satlng:
1.0768
satalt:
33930.709
satid:
10646
satname:
DELTA 1 DEB
intDesignator:
1976-077G
launchDate:
1976-07-29
satlat:
59.8713
satlng:
8.8108
satalt:
1630.465
satid:
10730
satname:
DELTA 1 DEB
intDesignator:
1975-027E
launchDate:
1975-04-09
satlat:
60.7378
satlng:
-3.9179
satalt:
974.338
satid:
10936
satname:
COSMOS 1019
intDesignator:
1978-056G
launchDate:
1978-06-07
satlat:
57.6728
satlng:
11.4132
satalt:
1433.2053
satid:
12833
satname:
COSMOS 1109 DEB
intDesignator:
1979-058E
launchDate:
1979-06-27
satlat:
72.6522
satlng:
47.046
satalt:
20156.1243
satid:
12998
satname:
RADIO 8
intDesignator:
1981-120B
launchDate:
1981-12-17
satlat:
64.613
satlng:
10.1872
satalt:
1684.4456
satid:
13298
satname:
SL-6 R/B(2)
intDesignator:
1982-064D
launchDate:
1982-06-25
satlat:
44.439
satlng:
14.2871
satalt:
18697.456
satid:
13610
satname:
SL-12 R/B(2)
intDesignator:
1982-100H
launchDate:
1982-10-12
satlat:
46.9228
satlng:
2.1065
satalt:
19060.8574
satid:
13897
satname:
SL-6 R/B(2)
intDesignator:
1983-019D
launchDate:
1983-03-16
satlat:
62.0968
satlng:
55.2494
satalt:
36551.9684
satid:
14059
satname:
SL-8 R/B
intDesignator:
1983-042B
launchDate:
1983-05-06
satlat:
61.3961
satlng:
7.9781
satalt:
965.5786
satid:
14238
satname:
TITAN 34B AGENA D R/B
intDesignator:
1983-078B
launchDate:
1983-07-31
satlat:
49.916
satlng:
-3.1061
satalt:
23649.6508
satid:
15214
satname:
MOLNIYA 1-62
intDesignator:
1984-089A
launchDate:
1984-08-24
satlat:
60.6844
satlng:
-42.9051
satalt:
29282.4069
satid:
15226
satname:
USA 4
intDesignator:
1984-091A
launchDate:
1984-08-28
satlat:
45.6749
satlng:
12.6223
satalt:
31412.6631
satid:
15264
satname:
SL-12 R/B(2)
intDesignator:
1984-095F
launchDate:
1984-09-04
satlat:
55.7747
satlng:
-5.0016
satalt:
19123.6701

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.