Allemannsdata Wiki
Manual search

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.

ParameterRequirementJSON typeDescription
observer_latrequirednumberObserver latitude in WGS84 decimal degrees. Unit: decimal degrees (WGS84).
observer_lonrequirednumberObserver longitude in WGS84 decimal degrees. Unit: decimal degrees (WGS84).
observer_alt_moptionalnumberObserver altitude above sea level in metres. Unit: metres.
radius_degoptionalintegerSearch radius from 0 to 90 degrees. Unit: degrees.
category_idoptionalintegerN2YO category id; 0 means all categories, 1 brightest.
limitoptionalintegerGateway page size; default 25, maximum 100.
offsetoptionalintegerNumber 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.

Type: decimal number. Observer latitude in WGS84 decimal degrees. Unit: decimal degrees (WGS84).
Type: decimal number. Observer longitude in WGS84 decimal degrees. Unit: decimal degrees (WGS84).
Type: decimal number. Observer altitude above sea level in metres. Unit: metres.
Type: integer. Search radius from 0 to 90 degrees. Unit: degrees.
Type: integer. N2YO category id; 0 means all categories, 1 brightest.

Result

Source: N2YO satellite data. Retrieved 2026-10-23T14:01:14Z in 0.964 seconds.

info:
category:
ANY
transactionscount:
99
satcount:
120
above:

25 results

  1. satid:
    561
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1961-015GT
    launchDate:
    1961-06-29
    satlat:
    59.6595
    satlng:
    -5.109
    satalt:
    1556.5782
  2. satid:
    815
    satname:
    THOR AGENA D R/B
    intDesignator:
    1964-031C
    launchDate:
    1964-06-18
    satlat:
    56.3469
    satlng:
    5.671
    satalt:
    809.7141
  3. satid:
    837
    satname:
    OPS 3674 (VELA 4)
    intDesignator:
    1964-040B
    launchDate:
    1964-07-17
    satlat:
    47.3198
    satlng:
    -22.028
    satalt:
    153675.2171
  4. satid:
    4391
    satname:
    SL-8 R/B
    intDesignator:
    1970-036J
    launchDate:
    1970-04-25
    satlat:
    55.6075
    satlng:
    10.8487
    satalt:
    1566.2209
  5. satid:
    5337
    satname:
    COSMOS 374 DEB
    intDesignator:
    1970-089BS
    launchDate:
    1970-10-23
    satlat:
    56.0884
    satlng:
    10.9373
    satalt:
    1129.0754
  6. satid:
    5392
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025KX
    launchDate:
    1970-04-08
    satlat:
    57.174
    satlng:
    6.4678
    satalt:
    886.4958
  7. satid:
    7026
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086S
    launchDate:
    1973-11-06
    satlat:
    56.6316
    satlng:
    14.4125
    satalt:
    1485.9386
  8. satid:
    7079
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086BX
    launchDate:
    1973-11-06
    satlat:
    59.3268
    satlng:
    -4.7225
    satalt:
    1542.9602
  9. satid:
    7688
    satname:
    TITAN 34B R/B
    intDesignator:
    1975-017B
    launchDate:
    1975-03-10
    satlat:
    52.1923
    satlng:
    -16.8385
    satalt:
    13170.2696
  10. satid:
    7800
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-036D
    launchDate:
    1975-04-29
    satlat:
    62.827
    satlng:
    -4.3701
    satalt:
    38283.0667
  11. satid:
    8179
    satname:
    THORAD DELTA 1 DEB
    intDesignator:
    1974-089AV
    launchDate:
    1974-11-15
    satlat:
    64.6272
    satlng:
    3.2206
    satalt:
    1562.0182
  12. satid:
    8601
    satname:
    MOLNIYA 1-32
    intDesignator:
    1976-006A
    launchDate:
    1976-01-22
    satlat:
    60.5738
    satlng:
    -1.4107
    satalt:
    37291.4365
  13. satid:
    8788
    satname:
    THORAD DELTA 1 DEB
    intDesignator:
    1974-089DQ
    launchDate:
    1974-11-15
    satlat:
    62.4493
    satlng:
    -2.9994
    satalt:
    1519.9241
  14. satid:
    10615
    satname:
    COSMOS 839 DEB
    intDesignator:
    1976-067AP
    launchDate:
    1976-07-08
    satlat:
    65.2958
    satlng:
    8.3999
    satalt:
    1917.6141
  15. satid:
    11705
    satname:
    ATLAS 35F R/B
    intDesignator:
    1980-011B
    launchDate:
    1980-02-09
    satlat:
    64.0093
    satlng:
    -37.7107
    satalt:
    14401.1229
  16. satid:
    12329
    satname:
    KYOKKO 1 DEB
    intDesignator:
    1978-014C
    launchDate:
    1978-02-04
    satlat:
    55.744
    satlng:
    18.3019
    satalt:
    2647.0533
  17. satid:
    12376
    satname:
    COSMOS 1261
    intDesignator:
    1981-031A
    launchDate:
    1981-03-31
    satlat:
    60.5741
    satlng:
    -22.5905
    satalt:
    19772.6411
  18. satid:
    12627
    satname:
    COSMOS 1285
    intDesignator:
    1981-071A
    launchDate:
    1981-08-04
    satlat:
    38.156
    satlng:
    4.3386
    satalt:
    29169.9012
  19. satid:
    12834
    satname:
    COSMOS 1191 DEB
    intDesignator:
    1980-057F
    launchDate:
    1980-07-02
    satlat:
    58.159
    satlng:
    -17.7231
    satalt:
    8616.926
  20. satid:
    13124
    satname:
    COSMOS 1348
    intDesignator:
    1982-029A
    launchDate:
    1982-04-07
    satlat:
    71.5933
    satlng:
    -3.5258
    satalt:
    21614.8696
  21. satid:
    13205
    satname:
    COSMOS 1367
    intDesignator:
    1982-045A
    launchDate:
    1982-05-20
    satlat:
    56.8304
    satlng:
    -29.5669
    satalt:
    31159.5648
  22. satid:
    13882
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-015E
    launchDate:
    1983-03-11
    satlat:
    59.5134
    satlng:
    26.0137
    satalt:
    36752.8697
  23. satid:
    13897
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-019D
    launchDate:
    1983-03-16
    satlat:
    61.8396
    satlng:
    19.2575
    satalt:
    36080.9353
  24. satid:
    13904
    satname:
    SL-6 DEB
    intDesignator:
    1981-088G
    launchDate:
    1981-09-11
    satlat:
    54.5257
    satlng:
    29.1438
    satalt:
    13154.178
  25. satid:
    15698
    satname:
    COSMOS 1651 (GLONASS)
    intDesignator:
    1985-037B
    launchDate:
    1985-05-17
    satlat:
    41.1501
    satlng:
    -17.9348
    satalt:
    19142.8591
limit:
25
offset:
0
returned:
25
has_more_results:
yes
next_offset:
25
Show all fields in HTML
info:
category:
ANY
transactionscount:
99
satcount:
120
above:

25 results

  1. satid:
    561
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1961-015GT
    launchDate:
    1961-06-29
    satlat:
    59.6595
    satlng:
    -5.109
    satalt:
    1556.5782
  2. satid:
    815
    satname:
    THOR AGENA D R/B
    intDesignator:
    1964-031C
    launchDate:
    1964-06-18
    satlat:
    56.3469
    satlng:
    5.671
    satalt:
    809.7141
  3. satid:
    837
    satname:
    OPS 3674 (VELA 4)
    intDesignator:
    1964-040B
    launchDate:
    1964-07-17
    satlat:
    47.3198
    satlng:
    -22.028
    satalt:
    153675.2171
  4. satid:
    4391
    satname:
    SL-8 R/B
    intDesignator:
    1970-036J
    launchDate:
    1970-04-25
    satlat:
    55.6075
    satlng:
    10.8487
    satalt:
    1566.2209
  5. satid:
    5337
    satname:
    COSMOS 374 DEB
    intDesignator:
    1970-089BS
    launchDate:
    1970-10-23
    satlat:
    56.0884
    satlng:
    10.9373
    satalt:
    1129.0754
  6. satid:
    5392
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025KX
    launchDate:
    1970-04-08
    satlat:
    57.174
    satlng:
    6.4678
    satalt:
    886.4958
  7. satid:
    7026
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086S
    launchDate:
    1973-11-06
    satlat:
    56.6316
    satlng:
    14.4125
    satalt:
    1485.9386
  8. satid:
    7079
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086BX
    launchDate:
    1973-11-06
    satlat:
    59.3268
    satlng:
    -4.7225
    satalt:
    1542.9602
  9. satid:
    7688
    satname:
    TITAN 34B R/B
    intDesignator:
    1975-017B
    launchDate:
    1975-03-10
    satlat:
    52.1923
    satlng:
    -16.8385
    satalt:
    13170.2696
  10. satid:
    7800
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-036D
    launchDate:
    1975-04-29
    satlat:
    62.827
    satlng:
    -4.3701
    satalt:
    38283.0667
  11. satid:
    8179
    satname:
    THORAD DELTA 1 DEB
    intDesignator:
    1974-089AV
    launchDate:
    1974-11-15
    satlat:
    64.6272
    satlng:
    3.2206
    satalt:
    1562.0182
  12. satid:
    8601
    satname:
    MOLNIYA 1-32
    intDesignator:
    1976-006A
    launchDate:
    1976-01-22
    satlat:
    60.5738
    satlng:
    -1.4107
    satalt:
    37291.4365
  13. satid:
    8788
    satname:
    THORAD DELTA 1 DEB
    intDesignator:
    1974-089DQ
    launchDate:
    1974-11-15
    satlat:
    62.4493
    satlng:
    -2.9994
    satalt:
    1519.9241
  14. satid:
    10615
    satname:
    COSMOS 839 DEB
    intDesignator:
    1976-067AP
    launchDate:
    1976-07-08
    satlat:
    65.2958
    satlng:
    8.3999
    satalt:
    1917.6141
  15. satid:
    11705
    satname:
    ATLAS 35F R/B
    intDesignator:
    1980-011B
    launchDate:
    1980-02-09
    satlat:
    64.0093
    satlng:
    -37.7107
    satalt:
    14401.1229
  16. satid:
    12329
    satname:
    KYOKKO 1 DEB
    intDesignator:
    1978-014C
    launchDate:
    1978-02-04
    satlat:
    55.744
    satlng:
    18.3019
    satalt:
    2647.0533
  17. satid:
    12376
    satname:
    COSMOS 1261
    intDesignator:
    1981-031A
    launchDate:
    1981-03-31
    satlat:
    60.5741
    satlng:
    -22.5905
    satalt:
    19772.6411
  18. satid:
    12627
    satname:
    COSMOS 1285
    intDesignator:
    1981-071A
    launchDate:
    1981-08-04
    satlat:
    38.156
    satlng:
    4.3386
    satalt:
    29169.9012
  19. satid:
    12834
    satname:
    COSMOS 1191 DEB
    intDesignator:
    1980-057F
    launchDate:
    1980-07-02
    satlat:
    58.159
    satlng:
    -17.7231
    satalt:
    8616.926
  20. satid:
    13124
    satname:
    COSMOS 1348
    intDesignator:
    1982-029A
    launchDate:
    1982-04-07
    satlat:
    71.5933
    satlng:
    -3.5258
    satalt:
    21614.8696
  21. satid:
    13205
    satname:
    COSMOS 1367
    intDesignator:
    1982-045A
    launchDate:
    1982-05-20
    satlat:
    56.8304
    satlng:
    -29.5669
    satalt:
    31159.5648
  22. satid:
    13882
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-015E
    launchDate:
    1983-03-11
    satlat:
    59.5134
    satlng:
    26.0137
    satalt:
    36752.8697
  23. satid:
    13897
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-019D
    launchDate:
    1983-03-16
    satlat:
    61.8396
    satlng:
    19.2575
    satalt:
    36080.9353
  24. satid:
    13904
    satname:
    SL-6 DEB
    intDesignator:
    1981-088G
    launchDate:
    1981-09-11
    satlat:
    54.5257
    satlng:
    29.1438
    satalt:
    13154.178
  25. satid:
    15698
    satname:
    COSMOS 1651 (GLONASS)
    intDesignator:
    1985-037B
    launchDate:
    1985-05-17
    satlat:
    41.1501
    satlng:
    -17.9348
    satalt:
    19142.8591
limit:
25
offset:
0
returned:
25
has_more_results:
yes
next_offset:
25
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

  1. Replace the placeholders in the HTML GET template; remove optional parameters you do not need.
  2. Check types, units, limits and ID formats in the parameter table.
  3. 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

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.