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-09-24T23:12:03Z in 0.941 seconds.

info:
category:
ANY
transactionscount:
42
satcount:
122
above:

25 results

  1. satid:
    3121
    satname:
    ATLAS AGENA B DEB
    intDesignator:
    1963-030F
    launchDate:
    1963-07-19
    satlat:
    65.2751
    satlng:
    27.9435
    satalt:
    3739.1429
  2. satid:
    3748
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1961-015JD
    launchDate:
    1961-06-29
    satlat:
    59.0811
    satlng:
    5.6342
    satalt:
    1676.684
  3. satid:
    4628
    satname:
    COSMOS 375 DEB
    intDesignator:
    1970-091H
    launchDate:
    1970-10-30
    satlat:
    59.5236
    satlng:
    11.4682
    satalt:
    829.538
  4. satid:
    4922
    satname:
    COSMOS 394
    intDesignator:
    1971-010A
    launchDate:
    1971-02-09
    satlat:
    58.9428
    satlng:
    4.3588
    satalt:
    431.004
  5. satid:
    6267
    satname:
    COSMOS 532
    intDesignator:
    1972-087E
    launchDate:
    1972-11-01
    satlat:
    61.0097
    satlng:
    -1.5721
    satalt:
    1367.8372
  6. satid:
    7373
    satname:
    SL-6 R/B(2)
    intDesignator:
    1974-026E
    launchDate:
    1974-04-26
    satlat:
    60.4737
    satlng:
    49.8934
    satalt:
    34083.6985
  7. satid:
    7629
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-007D
    launchDate:
    1975-01-30
    satlat:
    48.2931
    satlng:
    29.8611
    satalt:
    33511.7661
  8. satid:
    7822
    satname:
    COSMOS 733
    intDesignator:
    1975-045B
    launchDate:
    1975-05-28
    satlat:
    63.7154
    satlng:
    11.2934
    satalt:
    1481.9602
  9. satid:
    8564
    satname:
    THORAD DELTA 1 DEB
    intDesignator:
    1974-089DB
    launchDate:
    1974-11-15
    satlat:
    59.8774
    satlng:
    12.7961
    satalt:
    1373.25
  10. satid:
    10893
    satname:
    OPS 5112 (NAVSTAR 2)
    intDesignator:
    1978-047A
    launchDate:
    1978-05-13
    satlat:
    60.9283
    satlng:
    -14.0818
    satalt:
    18932.6717
  11. satid:
    12818
    satname:
    COSMOS 1305
    intDesignator:
    1981-088A
    launchDate:
    1981-09-11
    satlat:
    62.2242
    satlng:
    47.5607
    satalt:
    13900.6317
  12. satid:
    13169
    satname:
    SL-6 R/B(2)
    intDesignator:
    1982-029D
    launchDate:
    1982-04-07
    satlat:
    66.9505
    satlng:
    20.846
    satalt:
    21475.349
  13. satid:
    14131
    satname:
    SL-6 DEB
    intDesignator:
    1981-088M
    launchDate:
    1981-09-11
    satlat:
    62.9107
    satlng:
    -9.3074
    satalt:
    4104.0772
  14. satid:
    14591
    satname:
    COSMOS 1520 (GLONASS)
    intDesignator:
    1983-127B
    launchDate:
    1983-12-29
    satlat:
    59.8259
    satlng:
    22.6437
    satalt:
    19150.0761
  15. satid:
    15098
    satname:
    SL-6 R/B(2)
    intDesignator:
    1984-071D
    launchDate:
    1984-07-03
    satlat:
    66.0689
    satlng:
    48.4016
    satalt:
    29716.8108
  16. satid:
    15223
    satname:
    SL-6 R/B(2)
    intDesignator:
    1984-089D
    launchDate:
    1984-08-24
    satlat:
    60.679
    satlng:
    3.6943
    satalt:
    39011.3182
  17. satid:
    15271
    satname:
    NAVSTAR 10 (USA 5)
    intDesignator:
    1984-097A
    launchDate:
    1984-09-08
    satlat:
    60.4097
    satlng:
    5.0921
    satalt:
    21258.2952
  18. satid:
    15429
    satname:
    MOLNIYA 1-63
    intDesignator:
    1984-124A
    launchDate:
    1984-12-14
    satlat:
    52.0788
    satlng:
    24.2163
    satalt:
    35103.0757
  19. satid:
    15741
    satname:
    SL-6 R/B(2)
    intDesignator:
    1985-040D
    launchDate:
    1985-05-29
    satlat:
    60.4718
    satlng:
    -9.2335
    satalt:
    40416.8337
  20. satid:
    16397
    satname:
    COSMOS 1711 (GLONASS)
    intDesignator:
    1985-118B
    launchDate:
    1985-12-24
    satlat:
    57.9784
    satlng:
    14.6155
    satalt:
    19151.5145
  21. satid:
    16854
    satname:
    SL-6 R/B(2)
    intDesignator:
    1986-050D
    launchDate:
    1986-07-05
    satlat:
    65.0604
    satlng:
    4.3943
    satalt:
    7671.3853
  22. satid:
    18355
    satname:
    COSMOS 1883 (GLONASS)
    intDesignator:
    1987-079A
    launchDate:
    1987-09-16
    satlat:
    48.9243
    satlng:
    -5.0022
    satalt:
    19152.0992
  23. satid:
    18691
    satname:
    OPS 4682 DEB
    intDesignator:
    1965-027AJ
    launchDate:
    1965-04-03
    satlat:
    58.5806
    satlng:
    6.6402
    satalt:
    1300.0322
  24. satid:
    18725
    satname:
    COSMOS 1823 DEB
    intDesignator:
    1987-020C
    launchDate:
    1987-02-20
    satlat:
    61.9581
    satlng:
    16.7787
    satalt:
    1537.0038
  25. satid:
    18949
    satname:
    SL-6 R/B(2)
    intDesignator:
    1988-017D
    launchDate:
    1988-03-11
    satlat:
    52.1637
    satlng:
    -33.1636
    satalt:
    24094.0917
limit:
25
offset:
0
returned:
25
has_more_results:
yes
truncated:
yes
next_offset:
25
Show all fields in HTML
info:
category:
ANY
transactionscount:
42
satcount:
122
above:

25 results

  1. satid:
    3121
    satname:
    ATLAS AGENA B DEB
    intDesignator:
    1963-030F
    launchDate:
    1963-07-19
    satlat:
    65.2751
    satlng:
    27.9435
    satalt:
    3739.1429
  2. satid:
    3748
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1961-015JD
    launchDate:
    1961-06-29
    satlat:
    59.0811
    satlng:
    5.6342
    satalt:
    1676.684
  3. satid:
    4628
    satname:
    COSMOS 375 DEB
    intDesignator:
    1970-091H
    launchDate:
    1970-10-30
    satlat:
    59.5236
    satlng:
    11.4682
    satalt:
    829.538
  4. satid:
    4922
    satname:
    COSMOS 394
    intDesignator:
    1971-010A
    launchDate:
    1971-02-09
    satlat:
    58.9428
    satlng:
    4.3588
    satalt:
    431.004
  5. satid:
    6267
    satname:
    COSMOS 532
    intDesignator:
    1972-087E
    launchDate:
    1972-11-01
    satlat:
    61.0097
    satlng:
    -1.5721
    satalt:
    1367.8372
  6. satid:
    7373
    satname:
    SL-6 R/B(2)
    intDesignator:
    1974-026E
    launchDate:
    1974-04-26
    satlat:
    60.4737
    satlng:
    49.8934
    satalt:
    34083.6985
  7. satid:
    7629
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-007D
    launchDate:
    1975-01-30
    satlat:
    48.2931
    satlng:
    29.8611
    satalt:
    33511.7661
  8. satid:
    7822
    satname:
    COSMOS 733
    intDesignator:
    1975-045B
    launchDate:
    1975-05-28
    satlat:
    63.7154
    satlng:
    11.2934
    satalt:
    1481.9602
  9. satid:
    8564
    satname:
    THORAD DELTA 1 DEB
    intDesignator:
    1974-089DB
    launchDate:
    1974-11-15
    satlat:
    59.8774
    satlng:
    12.7961
    satalt:
    1373.25
  10. satid:
    10893
    satname:
    OPS 5112 (NAVSTAR 2)
    intDesignator:
    1978-047A
    launchDate:
    1978-05-13
    satlat:
    60.9283
    satlng:
    -14.0818
    satalt:
    18932.6717
  11. satid:
    12818
    satname:
    COSMOS 1305
    intDesignator:
    1981-088A
    launchDate:
    1981-09-11
    satlat:
    62.2242
    satlng:
    47.5607
    satalt:
    13900.6317
  12. satid:
    13169
    satname:
    SL-6 R/B(2)
    intDesignator:
    1982-029D
    launchDate:
    1982-04-07
    satlat:
    66.9505
    satlng:
    20.846
    satalt:
    21475.349
  13. satid:
    14131
    satname:
    SL-6 DEB
    intDesignator:
    1981-088M
    launchDate:
    1981-09-11
    satlat:
    62.9107
    satlng:
    -9.3074
    satalt:
    4104.0772
  14. satid:
    14591
    satname:
    COSMOS 1520 (GLONASS)
    intDesignator:
    1983-127B
    launchDate:
    1983-12-29
    satlat:
    59.8259
    satlng:
    22.6437
    satalt:
    19150.0761
  15. satid:
    15098
    satname:
    SL-6 R/B(2)
    intDesignator:
    1984-071D
    launchDate:
    1984-07-03
    satlat:
    66.0689
    satlng:
    48.4016
    satalt:
    29716.8108
  16. satid:
    15223
    satname:
    SL-6 R/B(2)
    intDesignator:
    1984-089D
    launchDate:
    1984-08-24
    satlat:
    60.679
    satlng:
    3.6943
    satalt:
    39011.3182
  17. satid:
    15271
    satname:
    NAVSTAR 10 (USA 5)
    intDesignator:
    1984-097A
    launchDate:
    1984-09-08
    satlat:
    60.4097
    satlng:
    5.0921
    satalt:
    21258.2952
  18. satid:
    15429
    satname:
    MOLNIYA 1-63
    intDesignator:
    1984-124A
    launchDate:
    1984-12-14
    satlat:
    52.0788
    satlng:
    24.2163
    satalt:
    35103.0757
  19. satid:
    15741
    satname:
    SL-6 R/B(2)
    intDesignator:
    1985-040D
    launchDate:
    1985-05-29
    satlat:
    60.4718
    satlng:
    -9.2335
    satalt:
    40416.8337
  20. satid:
    16397
    satname:
    COSMOS 1711 (GLONASS)
    intDesignator:
    1985-118B
    launchDate:
    1985-12-24
    satlat:
    57.9784
    satlng:
    14.6155
    satalt:
    19151.5145
  21. satid:
    16854
    satname:
    SL-6 R/B(2)
    intDesignator:
    1986-050D
    launchDate:
    1986-07-05
    satlat:
    65.0604
    satlng:
    4.3943
    satalt:
    7671.3853
  22. satid:
    18355
    satname:
    COSMOS 1883 (GLONASS)
    intDesignator:
    1987-079A
    launchDate:
    1987-09-16
    satlat:
    48.9243
    satlng:
    -5.0022
    satalt:
    19152.0992
  23. satid:
    18691
    satname:
    OPS 4682 DEB
    intDesignator:
    1965-027AJ
    launchDate:
    1965-04-03
    satlat:
    58.5806
    satlng:
    6.6402
    satalt:
    1300.0322
  24. satid:
    18725
    satname:
    COSMOS 1823 DEB
    intDesignator:
    1987-020C
    launchDate:
    1987-02-20
    satlat:
    61.9581
    satlng:
    16.7787
    satalt:
    1537.0038
  25. satid:
    18949
    satname:
    SL-6 R/B(2)
    intDesignator:
    1988-017D
    launchDate:
    1988-03-11
    satlat:
    52.1637
    satlng:
    -33.1636
    satalt:
    24094.0917
limit:
25
offset:
0
returned:
25
has_more_results:
yes
truncated:
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.