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-23T10:05:35Z in 1.014 seconds.

info:

category:: ANY
transactionscount:: 66
satcount:: 118

above:

25 results

satid:
589
satname:
DASH 1
intDesignator:
1963-014D
launchDate:
1963-05-09
satlat:
69.5307
satlng:
2.3272
satalt:
3639.0389
satid:
837
satname:
OPS 3674 (VELA 4)
intDesignator:
1964-040B
launchDate:
1964-07-17
satlat:
47.9541
satlng:
30.211
satalt:
161722.4288
satid:
3094
satname:
DELTA 1 R/B
intDesignator:
1968-002B
launchDate:
1968-01-11
satlat:
71.0766
satlng:
9.0539
satalt:
1355.6364
satid:
6124
satname:
COSMOS 511
intDesignator:
1972-057H
launchDate:
1972-07-20
satlat:
72.8614
satlng:
15.9542
satalt:
1533.9233
satid:
6197
satname:
EXPLORER 47 (IMP-7)
intDesignator:
1972-073A
launchDate:
1972-09-23
satlat:
55.1751
satlng:
-27.9151
satalt:
266827.587
satid:
6677
satname:
COSMOS 566
intDesignator:
1973-037C
launchDate:
1973-06-08
satlat:
68.3624
satlng:
14.1701
satalt:
1494.0015
satid:
7008
satname:
COSMOS 627
intDesignator:
1973-109A
launchDate:
1973-12-29
satlat:
66.5906
satlng:
7.4112
satalt:
1014.9713
satid:
7017
satname:
DELTA 1 DEB
intDesignator:
1973-086H
launchDate:
1973-11-06
satlat:
64.843
satlng:
4.9294
satalt:
1502.1117
satid:
7194
satname:
DELTA 1 DEB
intDesignator:
1973-086FC
launchDate:
1973-11-06
satlat:
71.7
satlng:
4.81
satalt:
2259.3147
satid:
8195
satname:
MOLNIYA 2-14
intDesignator:
1975-081A
launchDate:
1975-09-09
satlat:
56.7256
satlng:
-29.4177
satalt:
36465.6037
satid:
8601
satname:
MOLNIYA 1-32
intDesignator:
1976-006A
launchDate:
1976-01-22
satlat:
57.3179
satlng:
-10.8102
satalt:
30667.8964
satid:
10089
satname:
SL-6 R/B(2)
intDesignator:
1977-047D
launchDate:
1977-06-16
satlat:
62.4036
satlng:
31.1069
satalt:
34026.6242
satid:
10150
satname:
COSMOS 931
intDesignator:
1977-068A
launchDate:
1977-07-20
satlat:
60.9436
satlng:
8.8922
satalt:
30027.0484
satid:
10615
satname:
COSMOS 839 DEB
intDesignator:
1976-067AP
launchDate:
1976-07-08
satlat:
62.6616
satlng:
21.2772
satalt:
1822.4972
satid:
10664
satname:
KYOKKO 1 (EXOS A)
intDesignator:
1978-014A
launchDate:
1978-02-04
satlat:
65.4419
satlng:
-0.2903
satalt:
2498.8488
satid:
12093
satname:
OPS 5805
intDesignator:
1980-100A
launchDate:
1980-12-13
satlat:
59.2729
satlng:
63.6632
satalt:
35229.6067
satid:
12311
satname:
SL-6 R/B(2)
intDesignator:
1981-016E
launchDate:
1981-02-19
satlat:
61.2457
satlng:
-18.4825
satalt:
31981.3003
satid:
12643
satname:
COSMOS 1294
intDesignator:
1981-074H
launchDate:
1981-08-06
satlat:
64.208
satlng:
16.2383
satalt:
1403.6407
satid:
13875
satname:
MOLNIYA 3-20
intDesignator:
1983-015A
launchDate:
1983-03-11
satlat:
60.5027
satlng:
56.1943
satalt:
38289.7733
satid:
14238
satname:
TITAN 34B AGENA D R/B
intDesignator:
1983-078B
launchDate:
1983-07-31
satlat:
63.5391
satlng:
-31.1773
satalt:
30533.3618
satid:
14736
satname:
COSMOS 1317 DEB
intDesignator:
1981-108G
launchDate:
1981-10-31
satlat:
64.4234
satlng:
64.4464
satalt:
28501.0081
satid:
15226
satname:
USA 4
intDesignator:
1984-091A
launchDate:
1984-08-28
satlat:
56.3609
satlng:
20.1391
satalt:
36829.7443
satid:
15267
satname:
COSMOS 1596
intDesignator:
1984-096A
launchDate:
1984-09-07
satlat:
63.0969
satlng:
-2.0051
satalt:
4152.6938
satid:
15617
satname:
COSMOS 1635
intDesignator:
1985-023A
launchDate:
1985-03-21
satlat:
72.4121
satlng:
22.1706
satalt:
1517.7318
satid:
16020
satname:
SCOUT G-1 DEB
intDesignator:
1985-066F
launchDate:
1985-08-03
satlat:
70.3406
satlng:
11.891
satalt:
1219.0411

limit:

offset:

returned:

has_more_results:

yes

next_offset:

Show all fields in HTML

info:

category:: ANY
transactionscount:: 66
satcount:: 118

above:

25 results

satid:
589
satname:
DASH 1
intDesignator:
1963-014D
launchDate:
1963-05-09
satlat:
69.5307
satlng:
2.3272
satalt:
3639.0389
satid:
837
satname:
OPS 3674 (VELA 4)
intDesignator:
1964-040B
launchDate:
1964-07-17
satlat:
47.9541
satlng:
30.211
satalt:
161722.4288
satid:
3094
satname:
DELTA 1 R/B
intDesignator:
1968-002B
launchDate:
1968-01-11
satlat:
71.0766
satlng:
9.0539
satalt:
1355.6364
satid:
6124
satname:
COSMOS 511
intDesignator:
1972-057H
launchDate:
1972-07-20
satlat:
72.8614
satlng:
15.9542
satalt:
1533.9233
satid:
6197
satname:
EXPLORER 47 (IMP-7)
intDesignator:
1972-073A
launchDate:
1972-09-23
satlat:
55.1751
satlng:
-27.9151
satalt:
266827.587
satid:
6677
satname:
COSMOS 566
intDesignator:
1973-037C
launchDate:
1973-06-08
satlat:
68.3624
satlng:
14.1701
satalt:
1494.0015
satid:
7008
satname:
COSMOS 627
intDesignator:
1973-109A
launchDate:
1973-12-29
satlat:
66.5906
satlng:
7.4112
satalt:
1014.9713
satid:
7017
satname:
DELTA 1 DEB
intDesignator:
1973-086H
launchDate:
1973-11-06
satlat:
64.843
satlng:
4.9294
satalt:
1502.1117
satid:
7194
satname:
DELTA 1 DEB
intDesignator:
1973-086FC
launchDate:
1973-11-06
satlat:
71.7
satlng:
4.81
satalt:
2259.3147
satid:
8195
satname:
MOLNIYA 2-14
intDesignator:
1975-081A
launchDate:
1975-09-09
satlat:
56.7256
satlng:
-29.4177
satalt:
36465.6037
satid:
8601
satname:
MOLNIYA 1-32
intDesignator:
1976-006A
launchDate:
1976-01-22
satlat:
57.3179
satlng:
-10.8102
satalt:
30667.8964
satid:
10089
satname:
SL-6 R/B(2)
intDesignator:
1977-047D
launchDate:
1977-06-16
satlat:
62.4036
satlng:
31.1069
satalt:
34026.6242
satid:
10150
satname:
COSMOS 931
intDesignator:
1977-068A
launchDate:
1977-07-20
satlat:
60.9436
satlng:
8.8922
satalt:
30027.0484
satid:
10615
satname:
COSMOS 839 DEB
intDesignator:
1976-067AP
launchDate:
1976-07-08
satlat:
62.6616
satlng:
21.2772
satalt:
1822.4972
satid:
10664
satname:
KYOKKO 1 (EXOS A)
intDesignator:
1978-014A
launchDate:
1978-02-04
satlat:
65.4419
satlng:
-0.2903
satalt:
2498.8488
satid:
12093
satname:
OPS 5805
intDesignator:
1980-100A
launchDate:
1980-12-13
satlat:
59.2729
satlng:
63.6632
satalt:
35229.6067
satid:
12311
satname:
SL-6 R/B(2)
intDesignator:
1981-016E
launchDate:
1981-02-19
satlat:
61.2457
satlng:
-18.4825
satalt:
31981.3003
satid:
12643
satname:
COSMOS 1294
intDesignator:
1981-074H
launchDate:
1981-08-06
satlat:
64.208
satlng:
16.2383
satalt:
1403.6407
satid:
13875
satname:
MOLNIYA 3-20
intDesignator:
1983-015A
launchDate:
1983-03-11
satlat:
60.5027
satlng:
56.1943
satalt:
38289.7733
satid:
14238
satname:
TITAN 34B AGENA D R/B
intDesignator:
1983-078B
launchDate:
1983-07-31
satlat:
63.5391
satlng:
-31.1773
satalt:
30533.3618
satid:
14736
satname:
COSMOS 1317 DEB
intDesignator:
1981-108G
launchDate:
1981-10-31
satlat:
64.4234
satlng:
64.4464
satalt:
28501.0081
satid:
15226
satname:
USA 4
intDesignator:
1984-091A
launchDate:
1984-08-28
satlat:
56.3609
satlng:
20.1391
satalt:
36829.7443
satid:
15267
satname:
COSMOS 1596
intDesignator:
1984-096A
launchDate:
1984-09-07
satlat:
63.0969
satlng:
-2.0051
satalt:
4152.6938
satid:
15617
satname:
COSMOS 1635
intDesignator:
1985-023A
launchDate:
1985-03-21
satlat:
72.4121
satlng:
22.1706
satalt:
1517.7318
satid:
16020
satname:
SCOUT G-1 DEB
intDesignator:
1985-066F
launchDate:
1985-08-03
satlat:
70.3406
satlng:
11.891
satalt:
1219.0411

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.