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-15T19:44:42Z in 0.002 seconds.

info:

category:: ANY
transactionscount:: 98
satcount:: 137

above:

25 results

satid:
1804
satname:
ALOUETTE 2
intDesignator:
1965-098A
launchDate:
1965-11-29
satlat:
62.5723
satlng:
18.3621
satalt:
2116.2502
satid:
2377
satname:
WESTFORD NEEDLES
intDesignator:
1963-014X
launchDate:
1963-05-09
satlat:
64.9292
satlng:
11.7172
satalt:
3211.8018
satid:
3825
satname:
OV1-19
intDesignator:
1969-025C
launchDate:
1969-03-18
satlat:
66.5224
satlng:
27.0344
satalt:
4949.9459
satid:
5903
satname:
OPS 5058 (DMSP 5B F2)
intDesignator:
1972-018A
launchDate:
1972-03-24
satlat:
65.1139
satlng:
11.9916
satalt:
781.1689
satid:
5907
satname:
SL-8 R/B
intDesignator:
1972-019B
launchDate:
1972-03-25
satlat:
58.3901
satlng:
11.4393
satalt:
1197.4036
satid:
7629
satname:
SL-6 R/B(2)
intDesignator:
1975-007D
launchDate:
1975-01-30
satlat:
62.714
satlng:
42.6555
satalt:
33121.6476
satid:
8784
satname:
THORAD DELTA 1 DEB
intDesignator:
1974-089DL
launchDate:
1974-11-15
satlat:
63.8564
satlng:
9.1631
satalt:
1229.1967
satid:
8894
satname:
COSMOS 830
intDesignator:
1976-054F
launchDate:
1976-06-15
satlat:
63.3552
satlng:
13.7148
satalt:
1487.7292
satid:
10765
satname:
DELTA 1 DEB
intDesignator:
1976-077BN
launchDate:
1976-07-29
satlat:
58.3718
satlng:
3.6543
satalt:
1526.3687
satid:
10893
satname:
OPS 5112 (NAVSTAR 2)
intDesignator:
1978-047A
launchDate:
1978-05-13
satlat:
62.6034
satlng:
40.7486
satalt:
19081.3796
satid:
10949
satname:
SL-6 R/B(2)
intDesignator:
1978-055E
launchDate:
1978-06-02
satlat:
57.91
satlng:
-43.8278
satalt:
31145.9324
satid:
11057
satname:
MOLNIYA 3-10
intDesignator:
1978-095A
launchDate:
1978-10-13
satlat:
48.4677
satlng:
38.2847
satalt:
18888.5118
satid:
11079
satname:
SL-6 R/B(2)
intDesignator:
1978-095E
launchDate:
1978-10-13
satlat:
63.6115
satlng:
41.4499
satalt:
35452.4841
satid:
12719
satname:
COSMOS 1275 DEB
intDesignator:
1981-053BL
launchDate:
1981-06-04
satlat:
64.8077
satlng:
7.8491
satalt:
915.7174
satid:
12818
satname:
COSMOS 1305
intDesignator:
1981-088A
launchDate:
1981-09-11
satlat:
59.6901
satlng:
30.8737
satalt:
12973.2912
satid:
12868
satname:
COSMOS 970 DEB
intDesignator:
1977-121AW
launchDate:
1977-12-21
satlat:
62.0312
satlng:
3.8189
satalt:
966.6976
satid:
14146
satname:
OPS 6432 DEB
intDesignator:
1983-056F
launchDate:
1983-06-09
satlat:
61.71
satlng:
0.2321
satalt:
1057.1671
satid:
14191
satname:
SL-6 R/B(2)
intDesignator:
1983-070D
launchDate:
1983-07-08
satlat:
54.0122
satlng:
-37.8076
satalt:
34396.8055
satid:
14410
satname:
COSMOS 249 DEB
intDesignator:
1968-091CL
launchDate:
1968-10-20
satlat:
62.2659
satlng:
8.278
satalt:
966.121
satid:
14608
satname:
SL-12 R/B(AUX MOTOR)
intDesignator:
1983-127H
launchDate:
1983-12-29
satlat:
50.1377
satlng:
-4.3586
satalt:
9436.7678
satid:
14894
satname:
SL-6 R/B(2)
intDesignator:
1984-033D
launchDate:
1984-04-04
satlat:
51.4643
satlng:
-12.4786
satalt:
31872.7611
satid:
15227
satname:
TITAN 34B R/B
intDesignator:
1984-091B
launchDate:
1984-08-28
satlat:
54.629
satlng:
-38.8906
satalt:
29447.5043
satid:
15272
satname:
ATLAS 14E R/B
intDesignator:
1984-097B
launchDate:
1984-09-08
satlat:
64.7879
satlng:
47.6974
satalt:
19238.2837
satid:
15330
satname:
COSMOS 1579 FUEL CORE
intDesignator:
1984-069D
launchDate:
1984-06-29
satlat:
65.1551
satlng:
5.4325
satalt:
975.7858
satid:
15741
satname:
SL-6 R/B(2)
intDesignator:
1985-040D
launchDate:
1985-05-29
satlat:
61.5425
satlng:
33.1411
satalt:
39938.3132

limit:

offset:

returned:

has_more_results:

yes

next_offset:

Show all fields in HTML

info:

category:: ANY
transactionscount:: 98
satcount:: 137

above:

25 results

satid:
1804
satname:
ALOUETTE 2
intDesignator:
1965-098A
launchDate:
1965-11-29
satlat:
62.5723
satlng:
18.3621
satalt:
2116.2502
satid:
2377
satname:
WESTFORD NEEDLES
intDesignator:
1963-014X
launchDate:
1963-05-09
satlat:
64.9292
satlng:
11.7172
satalt:
3211.8018
satid:
3825
satname:
OV1-19
intDesignator:
1969-025C
launchDate:
1969-03-18
satlat:
66.5224
satlng:
27.0344
satalt:
4949.9459
satid:
5903
satname:
OPS 5058 (DMSP 5B F2)
intDesignator:
1972-018A
launchDate:
1972-03-24
satlat:
65.1139
satlng:
11.9916
satalt:
781.1689
satid:
5907
satname:
SL-8 R/B
intDesignator:
1972-019B
launchDate:
1972-03-25
satlat:
58.3901
satlng:
11.4393
satalt:
1197.4036
satid:
7629
satname:
SL-6 R/B(2)
intDesignator:
1975-007D
launchDate:
1975-01-30
satlat:
62.714
satlng:
42.6555
satalt:
33121.6476
satid:
8784
satname:
THORAD DELTA 1 DEB
intDesignator:
1974-089DL
launchDate:
1974-11-15
satlat:
63.8564
satlng:
9.1631
satalt:
1229.1967
satid:
8894
satname:
COSMOS 830
intDesignator:
1976-054F
launchDate:
1976-06-15
satlat:
63.3552
satlng:
13.7148
satalt:
1487.7292
satid:
10765
satname:
DELTA 1 DEB
intDesignator:
1976-077BN
launchDate:
1976-07-29
satlat:
58.3718
satlng:
3.6543
satalt:
1526.3687
satid:
10893
satname:
OPS 5112 (NAVSTAR 2)
intDesignator:
1978-047A
launchDate:
1978-05-13
satlat:
62.6034
satlng:
40.7486
satalt:
19081.3796
satid:
10949
satname:
SL-6 R/B(2)
intDesignator:
1978-055E
launchDate:
1978-06-02
satlat:
57.91
satlng:
-43.8278
satalt:
31145.9324
satid:
11057
satname:
MOLNIYA 3-10
intDesignator:
1978-095A
launchDate:
1978-10-13
satlat:
48.4677
satlng:
38.2847
satalt:
18888.5118
satid:
11079
satname:
SL-6 R/B(2)
intDesignator:
1978-095E
launchDate:
1978-10-13
satlat:
63.6115
satlng:
41.4499
satalt:
35452.4841
satid:
12719
satname:
COSMOS 1275 DEB
intDesignator:
1981-053BL
launchDate:
1981-06-04
satlat:
64.8077
satlng:
7.8491
satalt:
915.7174
satid:
12818
satname:
COSMOS 1305
intDesignator:
1981-088A
launchDate:
1981-09-11
satlat:
59.6901
satlng:
30.8737
satalt:
12973.2912
satid:
12868
satname:
COSMOS 970 DEB
intDesignator:
1977-121AW
launchDate:
1977-12-21
satlat:
62.0312
satlng:
3.8189
satalt:
966.6976
satid:
14146
satname:
OPS 6432 DEB
intDesignator:
1983-056F
launchDate:
1983-06-09
satlat:
61.71
satlng:
0.2321
satalt:
1057.1671
satid:
14191
satname:
SL-6 R/B(2)
intDesignator:
1983-070D
launchDate:
1983-07-08
satlat:
54.0122
satlng:
-37.8076
satalt:
34396.8055
satid:
14410
satname:
COSMOS 249 DEB
intDesignator:
1968-091CL
launchDate:
1968-10-20
satlat:
62.2659
satlng:
8.278
satalt:
966.121
satid:
14608
satname:
SL-12 R/B(AUX MOTOR)
intDesignator:
1983-127H
launchDate:
1983-12-29
satlat:
50.1377
satlng:
-4.3586
satalt:
9436.7678
satid:
14894
satname:
SL-6 R/B(2)
intDesignator:
1984-033D
launchDate:
1984-04-04
satlat:
51.4643
satlng:
-12.4786
satalt:
31872.7611
satid:
15227
satname:
TITAN 34B R/B
intDesignator:
1984-091B
launchDate:
1984-08-28
satlat:
54.629
satlng:
-38.8906
satalt:
29447.5043
satid:
15272
satname:
ATLAS 14E R/B
intDesignator:
1984-097B
launchDate:
1984-09-08
satlat:
64.7879
satlng:
47.6974
satalt:
19238.2837
satid:
15330
satname:
COSMOS 1579 FUEL CORE
intDesignator:
1984-069D
launchDate:
1984-06-29
satlat:
65.1551
satlng:
5.4325
satalt:
975.7858
satid:
15741
satname:
SL-6 R/B(2)
intDesignator:
1985-040D
launchDate:
1985-05-29
satlat:
61.5425
satlng:
33.1411
satalt:
39938.3132

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.