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-17T16:12:34Z in 1.695 seconds.

info:

category:: ANY
transactionscount:: 45
satcount:: 116

above:

25 results

satid:
2361
satname:
WESTFORD NEEDLES
intDesignator:
1963-014L
launchDate:
1963-05-09
satlat:
81.9503
satlng:
61.2663
satalt:
3499.2195
satid:
3315
satname:
DELTA 1 R/B
intDesignator:
1968-055B
launchDate:
1968-07-04
satlat:
58.8855
satlng:
28.3006
satalt:
5349.8179
satid:
3975
satname:
DELTA 1 DEB
intDesignator:
1968-069F
launchDate:
1968-08-16
satlat:
75.3429
satlng:
25.0317
satalt:
1492.3076
satid:
5106
satname:
THOR DELTA 1 R/B
intDesignator:
1971-024B
launchDate:
1971-04-01
satlat:
76.0931
satlng:
31.6851
satalt:
1365.167
satid:
5180
satname:
COSMOS 409
intDesignator:
1971-038A
launchDate:
1971-04-28
satlat:
73.5236
satlng:
25.0755
satalt:
1192.461
satid:
6676
satname:
COSMOS 565
intDesignator:
1973-037B
launchDate:
1973-06-08
satlat:
72.9033
satlng:
45.9921
satalt:
1461.6536
satid:
7376
satname:
MOLNIYA 2-10
intDesignator:
1974-056A
launchDate:
1974-07-23
satlat:
63.4005
satlng:
86.1173
satalt:
37073.934
satid:
10155
satname:
SL-6 R/B(2)
intDesignator:
1977-054D
launchDate:
1977-06-24
satlat:
64.2213
satlng:
8.8108
satalt:
31222.4785
satid:
10760
satname:
DELTA 1 DEB
intDesignator:
1976-077BH
launchDate:
1976-07-29
satlat:
72.6097
satlng:
12.0608
satalt:
1858.96
satid:
11168
satname:
COSMOS 1067
intDesignator:
1978-122A
launchDate:
1978-12-26
satlat:
74.6521
satlng:
16.6167
satalt:
1213.3994
satid:
11896
satname:
MOLNIYA 3-13
intDesignator:
1980-063A
launchDate:
1980-07-18
satlat:
63.7186
satlng:
89.3614
satalt:
37784.7297
satid:
12262
satname:
DELTA 1 DEB
intDesignator:
1978-026DF
launchDate:
1978-03-05
satlat:
76.2967
satlng:
32.33
satalt:
860.4331
satid:
12580
satname:
DELTA 1 DEB
intDesignator:
1976-077DY
launchDate:
1976-07-29
satlat:
68.8142
satlng:
26.0349
satalt:
1811.8445
satid:
13124
satname:
COSMOS 1348
intDesignator:
1982-029A
launchDate:
1982-04-07
satlat:
49.5469
satlng:
29.127
satalt:
30472.6926
satid:
13882
satname:
SL-6 R/B(2)
intDesignator:
1983-015E
launchDate:
1983-03-11
satlat:
55.4816
satlng:
64.9897
satalt:
33468.8928
satid:
13897
satname:
SL-6 R/B(2)
intDesignator:
1983-019D
launchDate:
1983-03-16
satlat:
53.9783
satlng:
53.536
satalt:
34935.4967
satid:
15223
satname:
SL-6 R/B(2)
intDesignator:
1984-089D
launchDate:
1984-08-24
satlat:
60.2119
satlng:
85.4057
satalt:
38848.4042
satid:
17067
satname:
SL-8 R/B
intDesignator:
1986-086B
launchDate:
1986-11-13
satlat:
71.6409
satlng:
22.7758
satalt:
960.4229
satid:
17328
satname:
MOLNIYA 3-31
intDesignator:
1987-008A
launchDate:
1987-01-22
satlat:
60.4803
satlng:
54.8677
satalt:
39541.0253
satid:
17584
satname:
COSMOS 1829
intDesignator:
1987-026C
launchDate:
1987-03-13
satlat:
76.6379
satlng:
31.9503
satalt:
1424.3605
satid:
17585
satname:
COSMOS 1830
intDesignator:
1987-026D
launchDate:
1987-03-13
satlat:
70.0563
satlng:
17.2157
satalt:
1423.1999
satid:
17635
satname:
COSMOS 1275 DEB
intDesignator:
1981-053LH
launchDate:
1981-06-04
satlat:
72.3235
satlng:
34.2131
satalt:
846.1986
satid:
18374
satname:
SL-12 R/B(AUX MOTOR)
intDesignator:
1987-079G
launchDate:
1987-09-16
satlat:
64.8043
satlng:
29.701
satalt:
6176.8383
satid:
18949
satname:
SL-6 R/B(2)
intDesignator:
1988-017D
launchDate:
1988-03-11
satlat:
61.8974
satlng:
-12.595
satalt:
37484.3562
satid:
20309
satname:
DELTA 1 DEB
intDesignator:
1976-077FQ
launchDate:
1976-07-29
satlat:
69.6122
satlng:
44.2543
satalt:
1795.1158

limit:

offset:

returned:

has_more_results:

yes

next_offset:

Show all fields in HTML

info:

category:: ANY
transactionscount:: 45
satcount:: 116

above:

25 results

satid:
2361
satname:
WESTFORD NEEDLES
intDesignator:
1963-014L
launchDate:
1963-05-09
satlat:
81.9503
satlng:
61.2663
satalt:
3499.2195
satid:
3315
satname:
DELTA 1 R/B
intDesignator:
1968-055B
launchDate:
1968-07-04
satlat:
58.8855
satlng:
28.3006
satalt:
5349.8179
satid:
3975
satname:
DELTA 1 DEB
intDesignator:
1968-069F
launchDate:
1968-08-16
satlat:
75.3429
satlng:
25.0317
satalt:
1492.3076
satid:
5106
satname:
THOR DELTA 1 R/B
intDesignator:
1971-024B
launchDate:
1971-04-01
satlat:
76.0931
satlng:
31.6851
satalt:
1365.167
satid:
5180
satname:
COSMOS 409
intDesignator:
1971-038A
launchDate:
1971-04-28
satlat:
73.5236
satlng:
25.0755
satalt:
1192.461
satid:
6676
satname:
COSMOS 565
intDesignator:
1973-037B
launchDate:
1973-06-08
satlat:
72.9033
satlng:
45.9921
satalt:
1461.6536
satid:
7376
satname:
MOLNIYA 2-10
intDesignator:
1974-056A
launchDate:
1974-07-23
satlat:
63.4005
satlng:
86.1173
satalt:
37073.934
satid:
10155
satname:
SL-6 R/B(2)
intDesignator:
1977-054D
launchDate:
1977-06-24
satlat:
64.2213
satlng:
8.8108
satalt:
31222.4785
satid:
10760
satname:
DELTA 1 DEB
intDesignator:
1976-077BH
launchDate:
1976-07-29
satlat:
72.6097
satlng:
12.0608
satalt:
1858.96
satid:
11168
satname:
COSMOS 1067
intDesignator:
1978-122A
launchDate:
1978-12-26
satlat:
74.6521
satlng:
16.6167
satalt:
1213.3994
satid:
11896
satname:
MOLNIYA 3-13
intDesignator:
1980-063A
launchDate:
1980-07-18
satlat:
63.7186
satlng:
89.3614
satalt:
37784.7297
satid:
12262
satname:
DELTA 1 DEB
intDesignator:
1978-026DF
launchDate:
1978-03-05
satlat:
76.2967
satlng:
32.33
satalt:
860.4331
satid:
12580
satname:
DELTA 1 DEB
intDesignator:
1976-077DY
launchDate:
1976-07-29
satlat:
68.8142
satlng:
26.0349
satalt:
1811.8445
satid:
13124
satname:
COSMOS 1348
intDesignator:
1982-029A
launchDate:
1982-04-07
satlat:
49.5469
satlng:
29.127
satalt:
30472.6926
satid:
13882
satname:
SL-6 R/B(2)
intDesignator:
1983-015E
launchDate:
1983-03-11
satlat:
55.4816
satlng:
64.9897
satalt:
33468.8928
satid:
13897
satname:
SL-6 R/B(2)
intDesignator:
1983-019D
launchDate:
1983-03-16
satlat:
53.9783
satlng:
53.536
satalt:
34935.4967
satid:
15223
satname:
SL-6 R/B(2)
intDesignator:
1984-089D
launchDate:
1984-08-24
satlat:
60.2119
satlng:
85.4057
satalt:
38848.4042
satid:
17067
satname:
SL-8 R/B
intDesignator:
1986-086B
launchDate:
1986-11-13
satlat:
71.6409
satlng:
22.7758
satalt:
960.4229
satid:
17328
satname:
MOLNIYA 3-31
intDesignator:
1987-008A
launchDate:
1987-01-22
satlat:
60.4803
satlng:
54.8677
satalt:
39541.0253
satid:
17584
satname:
COSMOS 1829
intDesignator:
1987-026C
launchDate:
1987-03-13
satlat:
76.6379
satlng:
31.9503
satalt:
1424.3605
satid:
17585
satname:
COSMOS 1830
intDesignator:
1987-026D
launchDate:
1987-03-13
satlat:
70.0563
satlng:
17.2157
satalt:
1423.1999
satid:
17635
satname:
COSMOS 1275 DEB
intDesignator:
1981-053LH
launchDate:
1981-06-04
satlat:
72.3235
satlng:
34.2131
satalt:
846.1986
satid:
18374
satname:
SL-12 R/B(AUX MOTOR)
intDesignator:
1987-079G
launchDate:
1987-09-16
satlat:
64.8043
satlng:
29.701
satalt:
6176.8383
satid:
18949
satname:
SL-6 R/B(2)
intDesignator:
1988-017D
launchDate:
1988-03-11
satlat:
61.8974
satlng:
-12.595
satalt:
37484.3562
satid:
20309
satname:
DELTA 1 DEB
intDesignator:
1976-077FQ
launchDate:
1976-07-29
satlat:
69.6122
satlng:
44.2543
satalt:
1795.1158

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.