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-25T10:08:42Z in 0.849 seconds.

info:
category:
ANY
transactionscount:
100
satcount:
121
above:

25 results

  1. satid:
    746
    satname:
    ELEKTRON 1
    intDesignator:
    1964-006A
    launchDate:
    1964-01-30
    satlat:
    60.9511
    satlng:
    -12.2897
    satalt:
    5950.9274
  2. satid:
    2255
    satname:
    THOR AGENA D R/B
    intDesignator:
    1966-056B
    launchDate:
    1966-06-24
    satlat:
    66.2014
    satlng:
    20.6358
    satalt:
    4205.8901
  3. satid:
    2377
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014X
    launchDate:
    1963-05-09
    satlat:
    70.9844
    satlng:
    5.7837
    satalt:
    3696.7992
  4. satid:
    5755
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1969-082JP
    launchDate:
    1969-09-30
    satlat:
    67.1707
    satlng:
    22.8516
    satalt:
    743.9482
  5. satid:
    6319
    satname:
    COSMOS 539
    intDesignator:
    1972-102A
    launchDate:
    1972-12-21
    satlat:
    69.7385
    satlng:
    23.4574
    satalt:
    1385.4197
  6. satid:
    7169
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086EH
    launchDate:
    1973-11-06
    satlat:
    66.338
    satlng:
    24.1065
    satalt:
    1446.6956
  7. satid:
    7682
    satname:
    COSMOS 715
    intDesignator:
    1975-016E
    launchDate:
    1975-02-28
    satlat:
    70.9951
    satlng:
    2.881
    satalt:
    1515.9297
  8. satid:
    7688
    satname:
    TITAN 34B R/B
    intDesignator:
    1975-017B
    launchDate:
    1975-03-10
    satlat:
    63.2709
    satlng:
    38.0282
    satalt:
    15073.7241
  9. satid:
    8165
    satname:
    THORAD DELTA 1 DEB
    intDesignator:
    1974-089AF
    launchDate:
    1974-11-15
    satlat:
    67.2092
    satlng:
    24.721
    satalt:
    1461.7092
  10. satid:
    8519
    satname:
    METEOR 1-23
    intDesignator:
    1975-124A
    launchDate:
    1975-12-25
    satlat:
    70.6211
    satlng:
    24.4256
    satalt:
    862.6033
  11. satid:
    8601
    satname:
    MOLNIYA 1-32
    intDesignator:
    1976-006A
    launchDate:
    1976-01-22
    satlat:
    55.8684
    satlng:
    15.3853
    satalt:
    29411.2234
  12. satid:
    10586
    satname:
    COSMOS 979
    intDesignator:
    1978-005D
    launchDate:
    1978-01-10
    satlat:
    67.4567
    satlng:
    24.458
    satalt:
    1457.5265
  13. satid:
    10674
    satname:
    UME 2 (ISS-B)
    intDesignator:
    1978-018A
    launchDate:
    1978-02-16
    satlat:
    66.1818
    satlng:
    14.6517
    satalt:
    1142.3048
  14. satid:
    11076
    satname:
    SL-6 R/B(2)
    intDesignator:
    1978-083D
    launchDate:
    1978-09-06
    satlat:
    61.7809
    satlng:
    40.5784
    satalt:
    7454.2351
  15. satid:
    11705
    satname:
    ATLAS 35F R/B
    intDesignator:
    1980-011B
    launchDate:
    1980-02-09
    satlat:
    54.3615
    satlng:
    22.6271
    satalt:
    14951.9149
  16. satid:
    11847
    satname:
    SL-6 R/B(2)
    intDesignator:
    1980-050B
    launchDate:
    1980-06-14
    satlat:
    53.8711
    satlng:
    -13.044
    satalt:
    36433.6232
  17. satid:
    11909
    satname:
    SL-6 R/B(2)
    intDesignator:
    1980-063D
    launchDate:
    1980-07-18
    satlat:
    61.6227
    satlng:
    -36.0483
    satalt:
    39884.9745
  18. satid:
    12032
    satname:
    COSMOS 1217
    intDesignator:
    1980-085A
    launchDate:
    1980-10-24
    satlat:
    63.1581
    satlng:
    61.6156
    satalt:
    33488.0948
  19. satid:
    12078
    satname:
    COSMOS 1223
    intDesignator:
    1980-095A
    launchDate:
    1980-11-27
    satlat:
    52.0048
    satlng:
    43.6607
    satalt:
    32425.7096
  20. satid:
    12297
    satname:
    COSMOS 1244
    intDesignator:
    1981-013A
    launchDate:
    1981-02-12
    satlat:
    68.9566
    satlng:
    16.4117
    satalt:
    1012.941
  21. satid:
    13000
    satname:
    RADIO 4
    intDesignator:
    1981-120D
    launchDate:
    1981-12-17
    satlat:
    69.0345
    satlng:
    10.6487
    satalt:
    1672.7934
  22. satid:
    13075
    satname:
    SL-6 R/B(2)
    intDesignator:
    1982-015D
    launchDate:
    1982-02-26
    satlat:
    62.9213
    satlng:
    35.5073
    satalt:
    39193.0419
  23. satid:
    13080
    satname:
    COSMOS 1341
    intDesignator:
    1982-016A
    launchDate:
    1982-03-03
    satlat:
    50.4164
    satlng:
    -3.5731
    satalt:
    35297.9137
  24. satid:
    13539
    satname:
    DELTA 1 DEB
    intDesignator:
    1976-077EM
    launchDate:
    1976-07-29
    satlat:
    72.0644
    satlng:
    29.008
    satalt:
    2157.1952
  25. satid:
    13875
    satname:
    MOLNIYA 3-20
    intDesignator:
    1983-015A
    launchDate:
    1983-03-11
    satlat:
    61.0655
    satlng:
    50.215
    satalt:
    37391.2674
limit:
25
offset:
0
returned:
25
has_more_results:
yes
truncated:
yes
next_offset:
25
Show all fields in HTML
info:
category:
ANY
transactionscount:
100
satcount:
121
above:

25 results

  1. satid:
    746
    satname:
    ELEKTRON 1
    intDesignator:
    1964-006A
    launchDate:
    1964-01-30
    satlat:
    60.9511
    satlng:
    -12.2897
    satalt:
    5950.9274
  2. satid:
    2255
    satname:
    THOR AGENA D R/B
    intDesignator:
    1966-056B
    launchDate:
    1966-06-24
    satlat:
    66.2014
    satlng:
    20.6358
    satalt:
    4205.8901
  3. satid:
    2377
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014X
    launchDate:
    1963-05-09
    satlat:
    70.9844
    satlng:
    5.7837
    satalt:
    3696.7992
  4. satid:
    5755
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1969-082JP
    launchDate:
    1969-09-30
    satlat:
    67.1707
    satlng:
    22.8516
    satalt:
    743.9482
  5. satid:
    6319
    satname:
    COSMOS 539
    intDesignator:
    1972-102A
    launchDate:
    1972-12-21
    satlat:
    69.7385
    satlng:
    23.4574
    satalt:
    1385.4197
  6. satid:
    7169
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086EH
    launchDate:
    1973-11-06
    satlat:
    66.338
    satlng:
    24.1065
    satalt:
    1446.6956
  7. satid:
    7682
    satname:
    COSMOS 715
    intDesignator:
    1975-016E
    launchDate:
    1975-02-28
    satlat:
    70.9951
    satlng:
    2.881
    satalt:
    1515.9297
  8. satid:
    7688
    satname:
    TITAN 34B R/B
    intDesignator:
    1975-017B
    launchDate:
    1975-03-10
    satlat:
    63.2709
    satlng:
    38.0282
    satalt:
    15073.7241
  9. satid:
    8165
    satname:
    THORAD DELTA 1 DEB
    intDesignator:
    1974-089AF
    launchDate:
    1974-11-15
    satlat:
    67.2092
    satlng:
    24.721
    satalt:
    1461.7092
  10. satid:
    8519
    satname:
    METEOR 1-23
    intDesignator:
    1975-124A
    launchDate:
    1975-12-25
    satlat:
    70.6211
    satlng:
    24.4256
    satalt:
    862.6033
  11. satid:
    8601
    satname:
    MOLNIYA 1-32
    intDesignator:
    1976-006A
    launchDate:
    1976-01-22
    satlat:
    55.8684
    satlng:
    15.3853
    satalt:
    29411.2234
  12. satid:
    10586
    satname:
    COSMOS 979
    intDesignator:
    1978-005D
    launchDate:
    1978-01-10
    satlat:
    67.4567
    satlng:
    24.458
    satalt:
    1457.5265
  13. satid:
    10674
    satname:
    UME 2 (ISS-B)
    intDesignator:
    1978-018A
    launchDate:
    1978-02-16
    satlat:
    66.1818
    satlng:
    14.6517
    satalt:
    1142.3048
  14. satid:
    11076
    satname:
    SL-6 R/B(2)
    intDesignator:
    1978-083D
    launchDate:
    1978-09-06
    satlat:
    61.7809
    satlng:
    40.5784
    satalt:
    7454.2351
  15. satid:
    11705
    satname:
    ATLAS 35F R/B
    intDesignator:
    1980-011B
    launchDate:
    1980-02-09
    satlat:
    54.3615
    satlng:
    22.6271
    satalt:
    14951.9149
  16. satid:
    11847
    satname:
    SL-6 R/B(2)
    intDesignator:
    1980-050B
    launchDate:
    1980-06-14
    satlat:
    53.8711
    satlng:
    -13.044
    satalt:
    36433.6232
  17. satid:
    11909
    satname:
    SL-6 R/B(2)
    intDesignator:
    1980-063D
    launchDate:
    1980-07-18
    satlat:
    61.6227
    satlng:
    -36.0483
    satalt:
    39884.9745
  18. satid:
    12032
    satname:
    COSMOS 1217
    intDesignator:
    1980-085A
    launchDate:
    1980-10-24
    satlat:
    63.1581
    satlng:
    61.6156
    satalt:
    33488.0948
  19. satid:
    12078
    satname:
    COSMOS 1223
    intDesignator:
    1980-095A
    launchDate:
    1980-11-27
    satlat:
    52.0048
    satlng:
    43.6607
    satalt:
    32425.7096
  20. satid:
    12297
    satname:
    COSMOS 1244
    intDesignator:
    1981-013A
    launchDate:
    1981-02-12
    satlat:
    68.9566
    satlng:
    16.4117
    satalt:
    1012.941
  21. satid:
    13000
    satname:
    RADIO 4
    intDesignator:
    1981-120D
    launchDate:
    1981-12-17
    satlat:
    69.0345
    satlng:
    10.6487
    satalt:
    1672.7934
  22. satid:
    13075
    satname:
    SL-6 R/B(2)
    intDesignator:
    1982-015D
    launchDate:
    1982-02-26
    satlat:
    62.9213
    satlng:
    35.5073
    satalt:
    39193.0419
  23. satid:
    13080
    satname:
    COSMOS 1341
    intDesignator:
    1982-016A
    launchDate:
    1982-03-03
    satlat:
    50.4164
    satlng:
    -3.5731
    satalt:
    35297.9137
  24. satid:
    13539
    satname:
    DELTA 1 DEB
    intDesignator:
    1976-077EM
    launchDate:
    1976-07-29
    satlat:
    72.0644
    satlng:
    29.008
    satalt:
    2157.1952
  25. satid:
    13875
    satname:
    MOLNIYA 3-20
    intDesignator:
    1983-015A
    launchDate:
    1983-03-11
    satlat:
    61.0655
    satlng:
    50.215
    satalt:
    37391.2674
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.