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-15T18:17:55Z in 1.870 seconds.

info:

category:: ANY
transactionscount:: 85
satcount:: 113

above:

25 results

satid:
3669
satname:
ISIS 1
intDesignator:
1969-009A
launchDate:
1969-01-30
satlat:
68.0833
satlng:
8.4927
satalt:
2204.7144
satid:
4639
satname:
THORAD AGENA D DEB
intDesignator:
1970-025X
launchDate:
1970-04-08
satlat:
72.025
satlng:
20.3746
satalt:
1118.6252
satid:
5225
satname:
SL-8 DEB
intDesignator:
1970-102D
launchDate:
1970-12-02
satlat:
67.7536
satlng:
21.0194
satalt:
940.1263
satid:
7376
satname:
MOLNIYA 2-10
intDesignator:
1974-056A
launchDate:
1974-07-23
satlat:
64.7903
satlng:
90.9639
satalt:
37128.5035
satid:
7629
satname:
SL-6 R/B(2)
intDesignator:
1975-007D
launchDate:
1975-01-30
satlat:
68.6303
satlng:
28.5717
satalt:
30307.8628
satid:
8182
satname:
THORAD DELTA 1 DEB
intDesignator:
1974-089AY
launchDate:
1974-11-15
satlat:
74.7553
satlng:
14.3026
satalt:
1408.3732
satid:
9271
satname:
TITAN 34B AGENA R/B
intDesignator:
1976-080B
launchDate:
1976-08-06
satlat:
60.8205
satlng:
56.516
satalt:
30162.4285
satid:
9982
satname:
TANSEI 3 DEB
intDesignator:
1977-012F
launchDate:
1977-02-19
satlat:
63.5771
satlng:
10.281
satalt:
3305.4912
satid:
10155
satname:
SL-6 R/B(2)
intDesignator:
1977-054D
launchDate:
1977-06-24
satlat:
54.5447
satlng:
26.8565
satalt:
27930.594
satid:
10692
satname:
COSMOS 991
intDesignator:
1978-022A
launchDate:
1978-02-28
satlat:
70.8594
satlng:
18.3001
satalt:
1012.048
satid:
11057
satname:
MOLNIYA 3-10
intDesignator:
1978-095A
launchDate:
1978-10-13
satlat:
63.3884
satlng:
9.3022
satalt:
14053.8559
satid:
11079
satname:
SL-6 R/B(2)
intDesignator:
1978-095E
launchDate:
1978-10-13
satlat:
63.5392
satlng:
36.8221
satalt:
34596.7033
satid:
15272
satname:
ATLAS 14E R/B
intDesignator:
1984-097B
launchDate:
1984-09-08
satlat:
55.1663
satlng:
8.7591
satalt:
15079.5942
satid:
15741
satname:
SL-6 R/B(2)
intDesignator:
1985-040D
launchDate:
1985-05-29
satlat:
59.5376
satlng:
35.4785
satalt:
40271.9649
satid:
17328
satname:
MOLNIYA 3-31
intDesignator:
1987-008A
launchDate:
1987-01-22
satlat:
61.5837
satlng:
54.5399
satalt:
36824.6706
satid:
18701
satname:
COSMOS 1903
intDesignator:
1987-105A
launchDate:
1987-12-21
satlat:
66.4971
satlng:
9.6882
satalt:
8552.9835
satid:
20348
satname:
SL-3 DEB
intDesignator:
1972-049C
launchDate:
1972-06-30
satlat:
68.9088
satlng:
29.2267
satalt:
863.3812
satid:
20533
satname:
NAVSTAR 19 (USA 54)
intDesignator:
1990-025A
launchDate:
1990-03-26
satlat:
52.5678
satlng:
17.7245
satalt:
21174.1398
satid:
20850
satname:
CZ-4 DEB
intDesignator:
1990-081N
launchDate:
1990-09-03
satlat:
69.133
satlng:
13.97
satalt:
842.0795
satid:
21121
satname:
SL-6 R/B(2)
intDesignator:
1991-012D
launchDate:
1991-02-15
satlat:
64.2823
satlng:
-43.5405
satalt:
31286.9185
satid:
22056
satname:
COSMOS 2206 (GLONASS)
intDesignator:
1992-047A
launchDate:
1992-07-30
satlat:
63.5098
satlng:
76.2951
satalt:
19166.5626
satid:
22061
satname:
SL-12 R/B(2)
intDesignator:
1992-047F
launchDate:
1992-07-30
satlat:
57.9926
satlng:
49.1602
satalt:
19127.6877
satid:
22442
satname:
SL-16 DEB
intDesignator:
1992-093EK
launchDate:
1992-12-25
satlat:
70.9639
satlng:
21.1644
satalt:
764.6623
satid:
22561
satname:
START 1
intDesignator:
1993-014A
launchDate:
1993-03-25
satlat:
71.4682
satlng:
15.177
satalt:
957.7777
satid:
23048
satname:
SL-12 R/B(2)
intDesignator:
1994-021F
launchDate:
1994-04-11
satlat:
56.2801
satlng:
43.9745
satalt:
19156.3733

limit:

offset:

returned:

has_more_results:

yes

next_offset:

Show all fields in HTML

info:

category:: ANY
transactionscount:: 85
satcount:: 113

above:

25 results

satid:
3669
satname:
ISIS 1
intDesignator:
1969-009A
launchDate:
1969-01-30
satlat:
68.0833
satlng:
8.4927
satalt:
2204.7144
satid:
4639
satname:
THORAD AGENA D DEB
intDesignator:
1970-025X
launchDate:
1970-04-08
satlat:
72.025
satlng:
20.3746
satalt:
1118.6252
satid:
5225
satname:
SL-8 DEB
intDesignator:
1970-102D
launchDate:
1970-12-02
satlat:
67.7536
satlng:
21.0194
satalt:
940.1263
satid:
7376
satname:
MOLNIYA 2-10
intDesignator:
1974-056A
launchDate:
1974-07-23
satlat:
64.7903
satlng:
90.9639
satalt:
37128.5035
satid:
7629
satname:
SL-6 R/B(2)
intDesignator:
1975-007D
launchDate:
1975-01-30
satlat:
68.6303
satlng:
28.5717
satalt:
30307.8628
satid:
8182
satname:
THORAD DELTA 1 DEB
intDesignator:
1974-089AY
launchDate:
1974-11-15
satlat:
74.7553
satlng:
14.3026
satalt:
1408.3732
satid:
9271
satname:
TITAN 34B AGENA R/B
intDesignator:
1976-080B
launchDate:
1976-08-06
satlat:
60.8205
satlng:
56.516
satalt:
30162.4285
satid:
9982
satname:
TANSEI 3 DEB
intDesignator:
1977-012F
launchDate:
1977-02-19
satlat:
63.5771
satlng:
10.281
satalt:
3305.4912
satid:
10155
satname:
SL-6 R/B(2)
intDesignator:
1977-054D
launchDate:
1977-06-24
satlat:
54.5447
satlng:
26.8565
satalt:
27930.594
satid:
10692
satname:
COSMOS 991
intDesignator:
1978-022A
launchDate:
1978-02-28
satlat:
70.8594
satlng:
18.3001
satalt:
1012.048
satid:
11057
satname:
MOLNIYA 3-10
intDesignator:
1978-095A
launchDate:
1978-10-13
satlat:
63.3884
satlng:
9.3022
satalt:
14053.8559
satid:
11079
satname:
SL-6 R/B(2)
intDesignator:
1978-095E
launchDate:
1978-10-13
satlat:
63.5392
satlng:
36.8221
satalt:
34596.7033
satid:
15272
satname:
ATLAS 14E R/B
intDesignator:
1984-097B
launchDate:
1984-09-08
satlat:
55.1663
satlng:
8.7591
satalt:
15079.5942
satid:
15741
satname:
SL-6 R/B(2)
intDesignator:
1985-040D
launchDate:
1985-05-29
satlat:
59.5376
satlng:
35.4785
satalt:
40271.9649
satid:
17328
satname:
MOLNIYA 3-31
intDesignator:
1987-008A
launchDate:
1987-01-22
satlat:
61.5837
satlng:
54.5399
satalt:
36824.6706
satid:
18701
satname:
COSMOS 1903
intDesignator:
1987-105A
launchDate:
1987-12-21
satlat:
66.4971
satlng:
9.6882
satalt:
8552.9835
satid:
20348
satname:
SL-3 DEB
intDesignator:
1972-049C
launchDate:
1972-06-30
satlat:
68.9088
satlng:
29.2267
satalt:
863.3812
satid:
20533
satname:
NAVSTAR 19 (USA 54)
intDesignator:
1990-025A
launchDate:
1990-03-26
satlat:
52.5678
satlng:
17.7245
satalt:
21174.1398
satid:
20850
satname:
CZ-4 DEB
intDesignator:
1990-081N
launchDate:
1990-09-03
satlat:
69.133
satlng:
13.97
satalt:
842.0795
satid:
21121
satname:
SL-6 R/B(2)
intDesignator:
1991-012D
launchDate:
1991-02-15
satlat:
64.2823
satlng:
-43.5405
satalt:
31286.9185
satid:
22056
satname:
COSMOS 2206 (GLONASS)
intDesignator:
1992-047A
launchDate:
1992-07-30
satlat:
63.5098
satlng:
76.2951
satalt:
19166.5626
satid:
22061
satname:
SL-12 R/B(2)
intDesignator:
1992-047F
launchDate:
1992-07-30
satlat:
57.9926
satlng:
49.1602
satalt:
19127.6877
satid:
22442
satname:
SL-16 DEB
intDesignator:
1992-093EK
launchDate:
1992-12-25
satlat:
70.9639
satlng:
21.1644
satalt:
764.6623
satid:
22561
satname:
START 1
intDesignator:
1993-014A
launchDate:
1993-03-25
satlat:
71.4682
satlng:
15.177
satalt:
957.7777
satid:
23048
satname:
SL-12 R/B(2)
intDesignator:
1994-021F
launchDate:
1994-04-11
satlat:
56.2801
satlng:
43.9745
satalt:
19156.3733

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.