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-20T23:04:18Z in 1.760 seconds.

info:
category:
ANY
transactionscount:
76
satcount:
118
above:

25 results

  1. satid:
    2431
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014AC
    launchDate:
    1963-05-09
    satlat:
    68.4191
    satlng:
    -20.4558
    satalt:
    3337.729
  2. satid:
    4141
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1969-082AJ
    launchDate:
    1969-09-30
    satlat:
    65.5142
    satlng:
    1.722
    satalt:
    630.8289
  3. satid:
    4453
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1969-082EY
    launchDate:
    1969-09-30
    satlat:
    66.1588
    satlng:
    9.0735
    satalt:
    886.657
  4. satid:
    5015
    satname:
    COSMOS 397 DEB
    intDesignator:
    1971-015J
    launchDate:
    1971-02-25
    satlat:
    64.0317
    satlng:
    9.1778
    satalt:
    1479.5963
  5. satid:
    6302
    satname:
    SL-6 R/B(2)
    intDesignator:
    1972-072E
    launchDate:
    1972-09-19
    satlat:
    63.5515
    satlng:
    55.2919
    satalt:
    29534.5835
  6. satid:
    6680
    satname:
    COSMOS 569
    intDesignator:
    1973-037F
    launchDate:
    1973-06-08
    satlat:
    67.3477
    satlng:
    -8.8717
    satalt:
    1375.5146
  7. satid:
    7026
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086S
    launchDate:
    1973-11-06
    satlat:
    68.9146
    satlng:
    6.0492
    satalt:
    1517.7469
  8. satid:
    7218
    satname:
    OPS 8579 (DMSP 5B F5)
    intDesignator:
    1974-015A
    launchDate:
    1974-03-16
    satlat:
    67.7794
    satlng:
    3.5467
    satalt:
    820.5039
  9. satid:
    7373
    satname:
    SL-6 R/B(2)
    intDesignator:
    1974-026E
    launchDate:
    1974-04-26
    satlat:
    61.1642
    satlng:
    -35.7612
    satalt:
    36118.8591
  10. satid:
    9896
    satname:
    COSMOS 862 DEB
    intDesignator:
    1976-105N
    launchDate:
    1976-10-22
    satlat:
    61.0885
    satlng:
    -15.685
    satalt:
    23991.6035
  11. satid:
    10091
    satname:
    NTS 2
    intDesignator:
    1977-053A
    launchDate:
    1977-06-23
    satlat:
    59.3306
    satlng:
    -39.2742
    satalt:
    20356.165
  12. satid:
    10653
    satname:
    DELTA 1 DEB
    intDesignator:
    1976-077P
    launchDate:
    1976-07-29
    satlat:
    67.0355
    satlng:
    7.3607
    satalt:
    1652.7794
  13. satid:
    10660
    satname:
    DELTA 1 DEB
    intDesignator:
    1976-077W
    launchDate:
    1976-07-29
    satlat:
    63.1919
    satlng:
    -7.5659
    satalt:
    1742.3936
  14. satid:
    10715
    satname:
    DELTA 1 DEB
    intDesignator:
    1976-077AL
    launchDate:
    1976-07-29
    satlat:
    64.4537
    satlng:
    -1.6251
    satalt:
    1554.3341
  15. satid:
    11783
    satname:
    OPS 5118 (NAVSTAR 6)
    intDesignator:
    1980-032A
    launchDate:
    1980-04-26
    satlat:
    47.4727
    satlng:
    12.9435
    satalt:
    19414.5583
  16. satid:
    11852
    satname:
    OPS 1292
    intDesignator:
    1980-052C
    launchDate:
    1980-06-18
    satlat:
    67.1733
    satlng:
    -9.2086
    satalt:
    1339.2475
  17. satid:
    12815
    satname:
    COSMOS 931 DEB
    intDesignator:
    1977-068E
    launchDate:
    1977-07-20
    satlat:
    63.8309
    satlng:
    25.3111
    satalt:
    26728.5002
  18. satid:
    12818
    satname:
    COSMOS 1305
    intDesignator:
    1981-088A
    launchDate:
    1981-09-11
    satlat:
    61.8231
    satlng:
    13.0862
    satalt:
    13881.7912
  19. satid:
    12976
    satname:
    COSMOS 1321
    intDesignator:
    1981-116B
    launchDate:
    1981-11-28
    satlat:
    64.7393
    satlng:
    12.265
    satalt:
    1500.5927
  20. satid:
    13169
    satname:
    SL-6 R/B(2)
    intDesignator:
    1982-029D
    launchDate:
    1982-04-07
    satlat:
    72.0255
    satlng:
    34.3947
    satalt:
    26186.4466
  21. satid:
    14182
    satname:
    COSMOS 1481
    intDesignator:
    1983-070A
    launchDate:
    1983-07-08
    satlat:
    52.4847
    satlng:
    22.7559
    satalt:
    13566.1819
  22. satid:
    14595
    satname:
    SL-12 R/B(2)
    intDesignator:
    1983-127F
    launchDate:
    1983-12-29
    satlat:
    64.7578
    satlng:
    13.5151
    satalt:
    19124.08
  23. satid:
    15098
    satname:
    SL-6 R/B(2)
    intDesignator:
    1984-071D
    launchDate:
    1984-07-03
    satlat:
    69.6146
    satlng:
    35.1287
    satalt:
    31650.7155
  24. satid:
    15271
    satname:
    NAVSTAR 10 (USA 5)
    intDesignator:
    1984-097A
    launchDate:
    1984-09-08
    satlat:
    58.6658
    satlng:
    31.06
    satalt:
    21129.2827
  25. satid:
    15272
    satname:
    ATLAS 14E R/B
    intDesignator:
    1984-097B
    launchDate:
    1984-09-08
    satlat:
    60.59
    satlng:
    12.7927
    satalt:
    19372.0413
limit:
25
offset:
0
returned:
25
has_more_results:
yes
next_offset:
25
Show all fields in HTML
info:
category:
ANY
transactionscount:
76
satcount:
118
above:

25 results

  1. satid:
    2431
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014AC
    launchDate:
    1963-05-09
    satlat:
    68.4191
    satlng:
    -20.4558
    satalt:
    3337.729
  2. satid:
    4141
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1969-082AJ
    launchDate:
    1969-09-30
    satlat:
    65.5142
    satlng:
    1.722
    satalt:
    630.8289
  3. satid:
    4453
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1969-082EY
    launchDate:
    1969-09-30
    satlat:
    66.1588
    satlng:
    9.0735
    satalt:
    886.657
  4. satid:
    5015
    satname:
    COSMOS 397 DEB
    intDesignator:
    1971-015J
    launchDate:
    1971-02-25
    satlat:
    64.0317
    satlng:
    9.1778
    satalt:
    1479.5963
  5. satid:
    6302
    satname:
    SL-6 R/B(2)
    intDesignator:
    1972-072E
    launchDate:
    1972-09-19
    satlat:
    63.5515
    satlng:
    55.2919
    satalt:
    29534.5835
  6. satid:
    6680
    satname:
    COSMOS 569
    intDesignator:
    1973-037F
    launchDate:
    1973-06-08
    satlat:
    67.3477
    satlng:
    -8.8717
    satalt:
    1375.5146
  7. satid:
    7026
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086S
    launchDate:
    1973-11-06
    satlat:
    68.9146
    satlng:
    6.0492
    satalt:
    1517.7469
  8. satid:
    7218
    satname:
    OPS 8579 (DMSP 5B F5)
    intDesignator:
    1974-015A
    launchDate:
    1974-03-16
    satlat:
    67.7794
    satlng:
    3.5467
    satalt:
    820.5039
  9. satid:
    7373
    satname:
    SL-6 R/B(2)
    intDesignator:
    1974-026E
    launchDate:
    1974-04-26
    satlat:
    61.1642
    satlng:
    -35.7612
    satalt:
    36118.8591
  10. satid:
    9896
    satname:
    COSMOS 862 DEB
    intDesignator:
    1976-105N
    launchDate:
    1976-10-22
    satlat:
    61.0885
    satlng:
    -15.685
    satalt:
    23991.6035
  11. satid:
    10091
    satname:
    NTS 2
    intDesignator:
    1977-053A
    launchDate:
    1977-06-23
    satlat:
    59.3306
    satlng:
    -39.2742
    satalt:
    20356.165
  12. satid:
    10653
    satname:
    DELTA 1 DEB
    intDesignator:
    1976-077P
    launchDate:
    1976-07-29
    satlat:
    67.0355
    satlng:
    7.3607
    satalt:
    1652.7794
  13. satid:
    10660
    satname:
    DELTA 1 DEB
    intDesignator:
    1976-077W
    launchDate:
    1976-07-29
    satlat:
    63.1919
    satlng:
    -7.5659
    satalt:
    1742.3936
  14. satid:
    10715
    satname:
    DELTA 1 DEB
    intDesignator:
    1976-077AL
    launchDate:
    1976-07-29
    satlat:
    64.4537
    satlng:
    -1.6251
    satalt:
    1554.3341
  15. satid:
    11783
    satname:
    OPS 5118 (NAVSTAR 6)
    intDesignator:
    1980-032A
    launchDate:
    1980-04-26
    satlat:
    47.4727
    satlng:
    12.9435
    satalt:
    19414.5583
  16. satid:
    11852
    satname:
    OPS 1292
    intDesignator:
    1980-052C
    launchDate:
    1980-06-18
    satlat:
    67.1733
    satlng:
    -9.2086
    satalt:
    1339.2475
  17. satid:
    12815
    satname:
    COSMOS 931 DEB
    intDesignator:
    1977-068E
    launchDate:
    1977-07-20
    satlat:
    63.8309
    satlng:
    25.3111
    satalt:
    26728.5002
  18. satid:
    12818
    satname:
    COSMOS 1305
    intDesignator:
    1981-088A
    launchDate:
    1981-09-11
    satlat:
    61.8231
    satlng:
    13.0862
    satalt:
    13881.7912
  19. satid:
    12976
    satname:
    COSMOS 1321
    intDesignator:
    1981-116B
    launchDate:
    1981-11-28
    satlat:
    64.7393
    satlng:
    12.265
    satalt:
    1500.5927
  20. satid:
    13169
    satname:
    SL-6 R/B(2)
    intDesignator:
    1982-029D
    launchDate:
    1982-04-07
    satlat:
    72.0255
    satlng:
    34.3947
    satalt:
    26186.4466
  21. satid:
    14182
    satname:
    COSMOS 1481
    intDesignator:
    1983-070A
    launchDate:
    1983-07-08
    satlat:
    52.4847
    satlng:
    22.7559
    satalt:
    13566.1819
  22. satid:
    14595
    satname:
    SL-12 R/B(2)
    intDesignator:
    1983-127F
    launchDate:
    1983-12-29
    satlat:
    64.7578
    satlng:
    13.5151
    satalt:
    19124.08
  23. satid:
    15098
    satname:
    SL-6 R/B(2)
    intDesignator:
    1984-071D
    launchDate:
    1984-07-03
    satlat:
    69.6146
    satlng:
    35.1287
    satalt:
    31650.7155
  24. satid:
    15271
    satname:
    NAVSTAR 10 (USA 5)
    intDesignator:
    1984-097A
    launchDate:
    1984-09-08
    satlat:
    58.6658
    satlng:
    31.06
    satalt:
    21129.2827
  25. satid:
    15272
    satname:
    ATLAS 14E R/B
    intDesignator:
    1984-097B
    launchDate:
    1984-09-08
    satlat:
    60.59
    satlng:
    12.7927
    satalt:
    19372.0413
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.