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-17T10:04:47Z in 2.358 seconds.

info:

category:: ANY
transactionscount:: 99
satcount:: 124

above:

25 results

satid:
836
satname:
OPS 3662 (VELA 3)
intDesignator:
1964-040A
launchDate:
1964-07-17
satlat:
52.2893
satlng:
14.0827
satalt:
159548.3004
satid:
3605
satname:
OPS 7684
intDesignator:
1968-112B
launchDate:
1968-12-12
satlat:
55.4159
satlng:
2.9352
satalt:
1437.8006
satid:
4971
satname:
THORAD AGENA D DEB
intDesignator:
1970-025GR
launchDate:
1970-04-08
satlat:
60.69
satlng:
5.3642
satalt:
1533.2887
satid:
5871
satname:
COSMOS 252 DEB *
intDesignator:
1968-097DK
launchDate:
1968-11-01
satlat:
54.3239
satlng:
5.6944
satalt:
1553.4915
satid:
7688
satname:
TITAN 34B R/B
intDesignator:
1975-017B
launchDate:
1975-03-10
satlat:
62.7179
satlng:
-10.7256
satalt:
14725.769
satid:
7800
satname:
SL-6 R/B(2)
intDesignator:
1975-036D
launchDate:
1975-04-29
satlat:
63.0514
satlng:
30.1845
satalt:
34348.4693
satid:
8195
satname:
MOLNIYA 2-14
intDesignator:
1975-081A
launchDate:
1975-09-09
satlat:
62.8507
satlng:
-42.9081
satalt:
38166.1668
satid:
8601
satname:
MOLNIYA 1-32
intDesignator:
1976-006A
launchDate:
1976-01-22
satlat:
56.8156
satlng:
-5.3714
satalt:
30227.4342
satid:
10089
satname:
SL-6 R/B(2)
intDesignator:
1977-047D
launchDate:
1977-06-16
satlat:
59.4717
satlng:
45.7618
satalt:
34878.4848
satid:
10150
satname:
COSMOS 931
intDesignator:
1977-068A
launchDate:
1977-07-20
satlat:
66.1417
satlng:
2.6999
satalt:
27670.2552
satid:
11290
satname:
SL-3 DEB
intDesignator:
1979-021C
launchDate:
1979-03-01
satlat:
56.477
satlng:
6.9948
satalt:
843.0427
satid:
11909
satname:
SL-6 R/B(2)
intDesignator:
1980-063D
launchDate:
1980-07-18
satlat:
37.2043
satlng:
-16.4911
satalt:
21793.6321
satid:
12384
satname:
SL-6 R/B(2)
intDesignator:
1981-031D
launchDate:
1981-03-31
satlat:
65.7763
satlng:
1.9577
satalt:
13393.2218
satid:
12580
satname:
DELTA 1 DEB
intDesignator:
1976-077DY
launchDate:
1976-07-29
satlat:
61.6146
satlng:
-3.5979
satalt:
2187.2873
satid:
12680
satname:
SL-6 R/B(2)
intDesignator:
1981-071D
launchDate:
1981-08-04
satlat:
61.6838
satlng:
-7.402
satalt:
8977.4084
satid:
13606
satname:
COSMOS 1414 (GLONASS)
intDesignator:
1982-100D
launchDate:
1982-10-12
satlat:
51.3879
satlng:
33.9668
satalt:
19122.269
satid:
13844
satname:
SSA
intDesignator:
1983-008E
launchDate:
1983-02-09
satlat:
58.1105
satlng:
1.3332
satalt:
518.8954
satid:
13908
satname:
SL-6 DEB
intDesignator:
1981-088H
launchDate:
1981-09-11
satlat:
45.538
satlng:
24.1504
satalt:
13701.2455
satid:
14238
satname:
TITAN 34B AGENA D R/B
intDesignator:
1983-078B
launchDate:
1983-07-31
satlat:
62.9627
satlng:
-11.7528
satalt:
30705.2884
satid:
15226
satname:
USA 4
intDesignator:
1984-091A
launchDate:
1984-08-28
satlat:
58.7487
satlng:
19.9596
satalt:
37513.1482
satid:
15259
satname:
COSMOS 1593 (GLONASS)
intDesignator:
1984-095A
launchDate:
1984-09-04
satlat:
60.3029
satlng:
16.5208
satalt:
19153.217
satid:
15350
satname:
COSMOS 1604
intDesignator:
1984-107A
launchDate:
1984-10-04
satlat:
50.6635
satlng:
-28.2129
satalt:
32788.4473
satid:
15698
satname:
COSMOS 1651 (GLONASS)
intDesignator:
1985-037B
launchDate:
1985-05-17
satlat:
64.3288
satlng:
-32.407
satalt:
19117.6708
satid:
16533
satname:
SL-6 R/B(2)
intDesignator:
1986-011F
launchDate:
1986-02-01
satlat:
70.3535
satlng:
14.5802
satalt:
12090.0594
satid:
16849
satname:
COSMOS 1761
intDesignator:
1986-050A
launchDate:
1986-07-05
satlat:
54.432
satlng:
12.2022
satalt:
19047.8332

limit:

offset:

returned:

has_more_results:

yes

next_offset:

Show all fields in HTML

info:

category:: ANY
transactionscount:: 99
satcount:: 124

above:

25 results

satid:
836
satname:
OPS 3662 (VELA 3)
intDesignator:
1964-040A
launchDate:
1964-07-17
satlat:
52.2893
satlng:
14.0827
satalt:
159548.3004
satid:
3605
satname:
OPS 7684
intDesignator:
1968-112B
launchDate:
1968-12-12
satlat:
55.4159
satlng:
2.9352
satalt:
1437.8006
satid:
4971
satname:
THORAD AGENA D DEB
intDesignator:
1970-025GR
launchDate:
1970-04-08
satlat:
60.69
satlng:
5.3642
satalt:
1533.2887
satid:
5871
satname:
COSMOS 252 DEB *
intDesignator:
1968-097DK
launchDate:
1968-11-01
satlat:
54.3239
satlng:
5.6944
satalt:
1553.4915
satid:
7688
satname:
TITAN 34B R/B
intDesignator:
1975-017B
launchDate:
1975-03-10
satlat:
62.7179
satlng:
-10.7256
satalt:
14725.769
satid:
7800
satname:
SL-6 R/B(2)
intDesignator:
1975-036D
launchDate:
1975-04-29
satlat:
63.0514
satlng:
30.1845
satalt:
34348.4693
satid:
8195
satname:
MOLNIYA 2-14
intDesignator:
1975-081A
launchDate:
1975-09-09
satlat:
62.8507
satlng:
-42.9081
satalt:
38166.1668
satid:
8601
satname:
MOLNIYA 1-32
intDesignator:
1976-006A
launchDate:
1976-01-22
satlat:
56.8156
satlng:
-5.3714
satalt:
30227.4342
satid:
10089
satname:
SL-6 R/B(2)
intDesignator:
1977-047D
launchDate:
1977-06-16
satlat:
59.4717
satlng:
45.7618
satalt:
34878.4848
satid:
10150
satname:
COSMOS 931
intDesignator:
1977-068A
launchDate:
1977-07-20
satlat:
66.1417
satlng:
2.6999
satalt:
27670.2552
satid:
11290
satname:
SL-3 DEB
intDesignator:
1979-021C
launchDate:
1979-03-01
satlat:
56.477
satlng:
6.9948
satalt:
843.0427
satid:
11909
satname:
SL-6 R/B(2)
intDesignator:
1980-063D
launchDate:
1980-07-18
satlat:
37.2043
satlng:
-16.4911
satalt:
21793.6321
satid:
12384
satname:
SL-6 R/B(2)
intDesignator:
1981-031D
launchDate:
1981-03-31
satlat:
65.7763
satlng:
1.9577
satalt:
13393.2218
satid:
12580
satname:
DELTA 1 DEB
intDesignator:
1976-077DY
launchDate:
1976-07-29
satlat:
61.6146
satlng:
-3.5979
satalt:
2187.2873
satid:
12680
satname:
SL-6 R/B(2)
intDesignator:
1981-071D
launchDate:
1981-08-04
satlat:
61.6838
satlng:
-7.402
satalt:
8977.4084
satid:
13606
satname:
COSMOS 1414 (GLONASS)
intDesignator:
1982-100D
launchDate:
1982-10-12
satlat:
51.3879
satlng:
33.9668
satalt:
19122.269
satid:
13844
satname:
SSA
intDesignator:
1983-008E
launchDate:
1983-02-09
satlat:
58.1105
satlng:
1.3332
satalt:
518.8954
satid:
13908
satname:
SL-6 DEB
intDesignator:
1981-088H
launchDate:
1981-09-11
satlat:
45.538
satlng:
24.1504
satalt:
13701.2455
satid:
14238
satname:
TITAN 34B AGENA D R/B
intDesignator:
1983-078B
launchDate:
1983-07-31
satlat:
62.9627
satlng:
-11.7528
satalt:
30705.2884
satid:
15226
satname:
USA 4
intDesignator:
1984-091A
launchDate:
1984-08-28
satlat:
58.7487
satlng:
19.9596
satalt:
37513.1482
satid:
15259
satname:
COSMOS 1593 (GLONASS)
intDesignator:
1984-095A
launchDate:
1984-09-04
satlat:
60.3029
satlng:
16.5208
satalt:
19153.217
satid:
15350
satname:
COSMOS 1604
intDesignator:
1984-107A
launchDate:
1984-10-04
satlat:
50.6635
satlng:
-28.2129
satalt:
32788.4473
satid:
15698
satname:
COSMOS 1651 (GLONASS)
intDesignator:
1985-037B
launchDate:
1985-05-17
satlat:
64.3288
satlng:
-32.407
satalt:
19117.6708
satid:
16533
satname:
SL-6 R/B(2)
intDesignator:
1986-011F
launchDate:
1986-02-01
satlat:
70.3535
satlng:
14.5802
satalt:
12090.0594
satid:
16849
satname:
COSMOS 1761
intDesignator:
1986-050A
launchDate:
1986-07-05
satlat:
54.432
satlng:
12.2022
satalt:
19047.8332

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.