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-16T18:13:38Z in 1.034 seconds.

info:
category:
ANY
transactionscount:
93
satcount:
117
above:

25 results

  1. satid:
    138
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1961-015Y
    launchDate:
    1961-06-29
    satlat:
    57.0194
    satlng:
    3.4922
    satalt:
    888.6712
  2. satid:
    1948
    satname:
    THOR AGENA B DEB
    intDesignator:
    1965-098F
    launchDate:
    1965-11-29
    satlat:
    65.7754
    satlng:
    6.4667
    satalt:
    1569.9343
  3. satid:
    2647
    satname:
    SL-8 DEB
    intDesignator:
    1965-073L
    launchDate:
    1965-09-18
    satlat:
    56.1612
    satlng:
    12.7937
    satalt:
    1608.2436
  4. satid:
    2825
    satname:
    THOR AGENA D R/B
    intDesignator:
    1967-053B
    launchDate:
    1967-05-31
    satlat:
    62.9742
    satlng:
    8.5506
    satalt:
    914.1777
  5. satid:
    4895
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1969-082HE
    launchDate:
    1969-09-30
    satlat:
    60.607
    satlng:
    3.543
    satalt:
    731.582
  6. satid:
    4932
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025FY
    launchDate:
    1970-04-08
    satlat:
    60.0245
    satlng:
    3.8865
    satalt:
    895.4293
  7. satid:
    5088
    satname:
    COSMOS 397 DEB
    intDesignator:
    1971-015Q
    launchDate:
    1971-02-25
    satlat:
    61.8014
    satlng:
    11.7595
    satalt:
    1596.3635
  8. satid:
    7133
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086CX
    launchDate:
    1973-11-06
    satlat:
    58.0235
    satlng:
    1.5184
    satalt:
    1485.7746
  9. satid:
    7177
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086EP
    launchDate:
    1973-11-06
    satlat:
    58.5233
    satlng:
    0.8979
    satalt:
    1029.2294
  10. satid:
    7629
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-007D
    launchDate:
    1975-01-30
    satlat:
    68.5553
    satlng:
    29.6666
    satalt:
    30413.6133
  11. satid:
    9589
    satname:
    COSMOS 872
    intDesignator:
    1976-118B
    launchDate:
    1976-12-07
    satlat:
    64.8786
    satlng:
    4.6831
    satalt:
    1438.9372
  12. satid:
    10392
    satname:
    THORAD DELTA 1 DEB
    intDesignator:
    1974-089EH
    launchDate:
    1974-11-15
    satlat:
    59.4327
    satlng:
    6.8538
    satalt:
    1400.2401
  13. satid:
    10879
    satname:
    COSMOS 970 DEB
    intDesignator:
    1977-121AA
    launchDate:
    1977-12-21
    satlat:
    56.3772
    satlng:
    6.1165
    satalt:
    916.3614
  14. satid:
    10893
    satname:
    OPS 5112 (NAVSTAR 2)
    intDesignator:
    1978-047A
    launchDate:
    1978-05-13
    satlat:
    47.4876
    satlng:
    4
    satalt:
    18684.0711
  15. satid:
    11057
    satname:
    MOLNIYA 3-10
    intDesignator:
    1978-095A
    launchDate:
    1978-10-13
    satlat:
    57.8073
    satlng:
    37.073
    satalt:
    17007.0044
  16. satid:
    12193
    satname:
    DELTA 1 DEB
    intDesignator:
    1978-026AJ
    launchDate:
    1978-03-05
    satlat:
    60.6837
    satlng:
    14.3078
    satalt:
    994.3907
  17. satid:
    13575
    satname:
    DELTA 1 DEB
    intDesignator:
    1978-026FN
    launchDate:
    1978-03-05
    satlat:
    57.2774
    satlng:
    3.2303
    satalt:
    871.6558
  18. satid:
    13580
    satname:
    DELTA 1 DEB
    intDesignator:
    1978-026FT
    launchDate:
    1978-03-05
    satlat:
    62.7879
    satlng:
    9.4874
    satalt:
    786.2062
  19. satid:
    14191
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-070D
    launchDate:
    1983-07-08
    satlat:
    46.7657
    satlng:
    -28.0463
    satalt:
    33378.9397
  20. satid:
    14894
    satname:
    SL-6 R/B(2)
    intDesignator:
    1984-033D
    launchDate:
    1984-04-04
    satlat:
    44.3478
    satlng:
    -1.7729
    satalt:
    33900.868
  21. satid:
    15227
    satname:
    TITAN 34B R/B
    intDesignator:
    1984-091B
    launchDate:
    1984-08-28
    satlat:
    52.5687
    satlng:
    -26.2912
    satalt:
    27720.5524
  22. satid:
    15271
    satname:
    NAVSTAR 10 (USA 5)
    intDesignator:
    1984-097A
    launchDate:
    1984-09-08
    satlat:
    57.095
    satlng:
    43.6118
    satalt:
    21285.3109
  23. satid:
    15741
    satname:
    SL-6 R/B(2)
    intDesignator:
    1985-040D
    launchDate:
    1985-05-29
    satlat:
    58.3343
    satlng:
    30.2383
    satalt:
    39800.7804
  24. satid:
    17328
    satname:
    MOLNIYA 3-31
    intDesignator:
    1987-008A
    launchDate:
    1987-01-22
    satlat:
    61.5851
    satlng:
    54.4539
    satalt:
    36834.2743
  25. satid:
    18231
    satname:
    VIKING DEB
    intDesignator:
    1986-019RN
    launchDate:
    1986-02-22
    satlat:
    56.8669
    satlng:
    -6.9944
    satalt:
    4027.4229
limit:
25
offset:
0
returned:
25
has_more_results:
yes
next_offset:
25
Show all fields in HTML
info:
category:
ANY
transactionscount:
93
satcount:
117
above:

25 results

  1. satid:
    138
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1961-015Y
    launchDate:
    1961-06-29
    satlat:
    57.0194
    satlng:
    3.4922
    satalt:
    888.6712
  2. satid:
    1948
    satname:
    THOR AGENA B DEB
    intDesignator:
    1965-098F
    launchDate:
    1965-11-29
    satlat:
    65.7754
    satlng:
    6.4667
    satalt:
    1569.9343
  3. satid:
    2647
    satname:
    SL-8 DEB
    intDesignator:
    1965-073L
    launchDate:
    1965-09-18
    satlat:
    56.1612
    satlng:
    12.7937
    satalt:
    1608.2436
  4. satid:
    2825
    satname:
    THOR AGENA D R/B
    intDesignator:
    1967-053B
    launchDate:
    1967-05-31
    satlat:
    62.9742
    satlng:
    8.5506
    satalt:
    914.1777
  5. satid:
    4895
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1969-082HE
    launchDate:
    1969-09-30
    satlat:
    60.607
    satlng:
    3.543
    satalt:
    731.582
  6. satid:
    4932
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025FY
    launchDate:
    1970-04-08
    satlat:
    60.0245
    satlng:
    3.8865
    satalt:
    895.4293
  7. satid:
    5088
    satname:
    COSMOS 397 DEB
    intDesignator:
    1971-015Q
    launchDate:
    1971-02-25
    satlat:
    61.8014
    satlng:
    11.7595
    satalt:
    1596.3635
  8. satid:
    7133
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086CX
    launchDate:
    1973-11-06
    satlat:
    58.0235
    satlng:
    1.5184
    satalt:
    1485.7746
  9. satid:
    7177
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086EP
    launchDate:
    1973-11-06
    satlat:
    58.5233
    satlng:
    0.8979
    satalt:
    1029.2294
  10. satid:
    7629
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-007D
    launchDate:
    1975-01-30
    satlat:
    68.5553
    satlng:
    29.6666
    satalt:
    30413.6133
  11. satid:
    9589
    satname:
    COSMOS 872
    intDesignator:
    1976-118B
    launchDate:
    1976-12-07
    satlat:
    64.8786
    satlng:
    4.6831
    satalt:
    1438.9372
  12. satid:
    10392
    satname:
    THORAD DELTA 1 DEB
    intDesignator:
    1974-089EH
    launchDate:
    1974-11-15
    satlat:
    59.4327
    satlng:
    6.8538
    satalt:
    1400.2401
  13. satid:
    10879
    satname:
    COSMOS 970 DEB
    intDesignator:
    1977-121AA
    launchDate:
    1977-12-21
    satlat:
    56.3772
    satlng:
    6.1165
    satalt:
    916.3614
  14. satid:
    10893
    satname:
    OPS 5112 (NAVSTAR 2)
    intDesignator:
    1978-047A
    launchDate:
    1978-05-13
    satlat:
    47.4876
    satlng:
    4
    satalt:
    18684.0711
  15. satid:
    11057
    satname:
    MOLNIYA 3-10
    intDesignator:
    1978-095A
    launchDate:
    1978-10-13
    satlat:
    57.8073
    satlng:
    37.073
    satalt:
    17007.0044
  16. satid:
    12193
    satname:
    DELTA 1 DEB
    intDesignator:
    1978-026AJ
    launchDate:
    1978-03-05
    satlat:
    60.6837
    satlng:
    14.3078
    satalt:
    994.3907
  17. satid:
    13575
    satname:
    DELTA 1 DEB
    intDesignator:
    1978-026FN
    launchDate:
    1978-03-05
    satlat:
    57.2774
    satlng:
    3.2303
    satalt:
    871.6558
  18. satid:
    13580
    satname:
    DELTA 1 DEB
    intDesignator:
    1978-026FT
    launchDate:
    1978-03-05
    satlat:
    62.7879
    satlng:
    9.4874
    satalt:
    786.2062
  19. satid:
    14191
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-070D
    launchDate:
    1983-07-08
    satlat:
    46.7657
    satlng:
    -28.0463
    satalt:
    33378.9397
  20. satid:
    14894
    satname:
    SL-6 R/B(2)
    intDesignator:
    1984-033D
    launchDate:
    1984-04-04
    satlat:
    44.3478
    satlng:
    -1.7729
    satalt:
    33900.868
  21. satid:
    15227
    satname:
    TITAN 34B R/B
    intDesignator:
    1984-091B
    launchDate:
    1984-08-28
    satlat:
    52.5687
    satlng:
    -26.2912
    satalt:
    27720.5524
  22. satid:
    15271
    satname:
    NAVSTAR 10 (USA 5)
    intDesignator:
    1984-097A
    launchDate:
    1984-09-08
    satlat:
    57.095
    satlng:
    43.6118
    satalt:
    21285.3109
  23. satid:
    15741
    satname:
    SL-6 R/B(2)
    intDesignator:
    1985-040D
    launchDate:
    1985-05-29
    satlat:
    58.3343
    satlng:
    30.2383
    satalt:
    39800.7804
  24. satid:
    17328
    satname:
    MOLNIYA 3-31
    intDesignator:
    1987-008A
    launchDate:
    1987-01-22
    satlat:
    61.5851
    satlng:
    54.4539
    satalt:
    36834.2743
  25. satid:
    18231
    satname:
    VIKING DEB
    intDesignator:
    1986-019RN
    launchDate:
    1986-02-22
    satlat:
    56.8669
    satlng:
    -6.9944
    satalt:
    4027.4229
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.