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-16T17:18:39Z in 1.338 seconds.

info:
category:
ANY
transactionscount:
90
satcount:
112
above:

25 results

  1. satid:
    2364
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014P
    launchDate:
    1963-05-09
    satlat:
    75.4562
    satlng:
    -4.2611
    satalt:
    4199.2157
  2. satid:
    2371
    satname:
    MIDAS 4 DEB
    intDesignator:
    1961-028F
    launchDate:
    1961-10-21
    satlat:
    70.4357
    satlng:
    25.3147
    satalt:
    3091.9785
  3. satid:
    2532
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014AL
    launchDate:
    1963-05-09
    satlat:
    56.4252
    satlng:
    16.8087
    satalt:
    3829.8959
  4. satid:
    5042
    satname:
    COSMOS 397 DEB
    intDesignator:
    1971-015P
    launchDate:
    1971-02-25
    satlat:
    64.8709
    satlng:
    11.54
    satalt:
    1338.5428
  5. satid:
    7018
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086J
    launchDate:
    1973-11-06
    satlat:
    63.5672
    satlng:
    1.0135
    satalt:
    1529.2887
  6. satid:
    7629
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-007D
    launchDate:
    1975-01-30
    satlat:
    67.1272
    satlng:
    6.8555
    satalt:
    26474.41
  7. satid:
    7678
    satname:
    COSMOS 711
    intDesignator:
    1975-016A
    launchDate:
    1975-02-28
    satlat:
    66.2369
    satlng:
    14.2179
    satalt:
    1474.5953
  8. satid:
    8172
    satname:
    THORAD DELTA 1 DEB
    intDesignator:
    1974-089AN
    launchDate:
    1974-11-15
    satlat:
    62.6954
    satlng:
    0.3503
    satalt:
    1491.3565
  9. satid:
    9823
    satname:
    COSMOS 886 DEB
    intDesignator:
    1976-126AK
    launchDate:
    1976-12-27
    satlat:
    64.0302
    satlng:
    20.8689
    satalt:
    1485.2549
  10. satid:
    9983
    satname:
    TANSEI 3 DEB
    intDesignator:
    1977-012G
    launchDate:
    1977-02-19
    satlat:
    59.6677
    satlng:
    -0.3569
    satalt:
    3243.634
  11. satid:
    11057
    satname:
    MOLNIYA 3-10
    intDesignator:
    1978-095A
    launchDate:
    1978-10-13
    satlat:
    61.5367
    satlng:
    -12.319
    satalt:
    10681.1191
  12. satid:
    11135
    satname:
    COSMOS 1058
    intDesignator:
    1978-109H
    launchDate:
    1978-12-05
    satlat:
    67.3968
    satlng:
    1.0063
    satalt:
    1492.2543
  13. satid:
    12165
    satname:
    DELTA 1 DEB
    intDesignator:
    1978-026E
    launchDate:
    1978-03-05
    satlat:
    64.2937
    satlng:
    20.1808
    satalt:
    896.3843
  14. satid:
    12446
    satname:
    TITAN 34B R/B
    intDesignator:
    1981-038B
    launchDate:
    1981-04-24
    satlat:
    62.8832
    satlng:
    34.0619
    satalt:
    15786.9077
  15. satid:
    15597
    satname:
    COSMOS 1634
    intDesignator:
    1985-022A
    launchDate:
    1985-03-14
    satlat:
    63.5394
    satlng:
    6.3743
    satalt:
    976.7205
  16. satid:
    15741
    satname:
    SL-6 R/B(2)
    intDesignator:
    1985-040D
    launchDate:
    1985-05-29
    satlat:
    55.042
    satlng:
    33.9409
    satalt:
    37703.6751
  17. satid:
    17328
    satname:
    MOLNIYA 3-31
    intDesignator:
    1987-008A
    launchDate:
    1987-01-22
    satlat:
    61.8168
    satlng:
    53.996
    satalt:
    38974.5247
  18. satid:
    18779
    satname:
    DELTA 1 DEB
    intDesignator:
    1978-026HJ
    launchDate:
    1978-03-05
    satlat:
    61.7132
    satlng:
    11.9498
    satalt:
    762.658
  19. satid:
    18949
    satname:
    SL-6 R/B(2)
    intDesignator:
    1988-017D
    launchDate:
    1988-03-11
    satlat:
    61.8228
    satlng:
    -28.9255
    satalt:
    37520.9964
  20. satid:
    18957
    satname:
    COSMOS 1932
    intDesignator:
    1988-019A
    launchDate:
    1988-03-14
    satlat:
    62.9094
    satlng:
    12.0056
    satalt:
    986.1553
  21. satid:
    19451
    satname:
    SL-8 DEB
    intDesignator:
    1988-016K
    launchDate:
    1988-03-11
    satlat:
    68.4377
    satlng:
    5.1027
    satalt:
    1647.7132
  22. satid:
    19807
    satname:
    MOLNIYA 1-75
    intDesignator:
    1989-014A
    launchDate:
    1989-02-15
    satlat:
    61.7253
    satlng:
    -44.8893
    satalt:
    30291.4022
  23. satid:
    20030
    satname:
    COSMOS 839 DEB *
    intDesignator:
    1976-067BU
    launchDate:
    1976-07-08
    satlat:
    62.6414
    satlng:
    12.78
    satalt:
    1091.1691
  24. satid:
    20061
    satname:
    NAVSTAR 14 (USA 38)
    intDesignator:
    1989-044A
    launchDate:
    1989-06-10
    satlat:
    49.3611
    satlng:
    10.6224
    satalt:
    21336.272
  25. satid:
    21029
    satname:
    COSMOS 2115
    intDesignator:
    1990-114B
    launchDate:
    1990-12-22
    satlat:
    69.085
    satlng:
    9.1968
    satalt:
    1422.5472
limit:
25
offset:
0
returned:
25
has_more_results:
yes
next_offset:
25
Show all fields in HTML
info:
category:
ANY
transactionscount:
90
satcount:
112
above:

25 results

  1. satid:
    2364
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014P
    launchDate:
    1963-05-09
    satlat:
    75.4562
    satlng:
    -4.2611
    satalt:
    4199.2157
  2. satid:
    2371
    satname:
    MIDAS 4 DEB
    intDesignator:
    1961-028F
    launchDate:
    1961-10-21
    satlat:
    70.4357
    satlng:
    25.3147
    satalt:
    3091.9785
  3. satid:
    2532
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014AL
    launchDate:
    1963-05-09
    satlat:
    56.4252
    satlng:
    16.8087
    satalt:
    3829.8959
  4. satid:
    5042
    satname:
    COSMOS 397 DEB
    intDesignator:
    1971-015P
    launchDate:
    1971-02-25
    satlat:
    64.8709
    satlng:
    11.54
    satalt:
    1338.5428
  5. satid:
    7018
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086J
    launchDate:
    1973-11-06
    satlat:
    63.5672
    satlng:
    1.0135
    satalt:
    1529.2887
  6. satid:
    7629
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-007D
    launchDate:
    1975-01-30
    satlat:
    67.1272
    satlng:
    6.8555
    satalt:
    26474.41
  7. satid:
    7678
    satname:
    COSMOS 711
    intDesignator:
    1975-016A
    launchDate:
    1975-02-28
    satlat:
    66.2369
    satlng:
    14.2179
    satalt:
    1474.5953
  8. satid:
    8172
    satname:
    THORAD DELTA 1 DEB
    intDesignator:
    1974-089AN
    launchDate:
    1974-11-15
    satlat:
    62.6954
    satlng:
    0.3503
    satalt:
    1491.3565
  9. satid:
    9823
    satname:
    COSMOS 886 DEB
    intDesignator:
    1976-126AK
    launchDate:
    1976-12-27
    satlat:
    64.0302
    satlng:
    20.8689
    satalt:
    1485.2549
  10. satid:
    9983
    satname:
    TANSEI 3 DEB
    intDesignator:
    1977-012G
    launchDate:
    1977-02-19
    satlat:
    59.6677
    satlng:
    -0.3569
    satalt:
    3243.634
  11. satid:
    11057
    satname:
    MOLNIYA 3-10
    intDesignator:
    1978-095A
    launchDate:
    1978-10-13
    satlat:
    61.5367
    satlng:
    -12.319
    satalt:
    10681.1191
  12. satid:
    11135
    satname:
    COSMOS 1058
    intDesignator:
    1978-109H
    launchDate:
    1978-12-05
    satlat:
    67.3968
    satlng:
    1.0063
    satalt:
    1492.2543
  13. satid:
    12165
    satname:
    DELTA 1 DEB
    intDesignator:
    1978-026E
    launchDate:
    1978-03-05
    satlat:
    64.2937
    satlng:
    20.1808
    satalt:
    896.3843
  14. satid:
    12446
    satname:
    TITAN 34B R/B
    intDesignator:
    1981-038B
    launchDate:
    1981-04-24
    satlat:
    62.8832
    satlng:
    34.0619
    satalt:
    15786.9077
  15. satid:
    15597
    satname:
    COSMOS 1634
    intDesignator:
    1985-022A
    launchDate:
    1985-03-14
    satlat:
    63.5394
    satlng:
    6.3743
    satalt:
    976.7205
  16. satid:
    15741
    satname:
    SL-6 R/B(2)
    intDesignator:
    1985-040D
    launchDate:
    1985-05-29
    satlat:
    55.042
    satlng:
    33.9409
    satalt:
    37703.6751
  17. satid:
    17328
    satname:
    MOLNIYA 3-31
    intDesignator:
    1987-008A
    launchDate:
    1987-01-22
    satlat:
    61.8168
    satlng:
    53.996
    satalt:
    38974.5247
  18. satid:
    18779
    satname:
    DELTA 1 DEB
    intDesignator:
    1978-026HJ
    launchDate:
    1978-03-05
    satlat:
    61.7132
    satlng:
    11.9498
    satalt:
    762.658
  19. satid:
    18949
    satname:
    SL-6 R/B(2)
    intDesignator:
    1988-017D
    launchDate:
    1988-03-11
    satlat:
    61.8228
    satlng:
    -28.9255
    satalt:
    37520.9964
  20. satid:
    18957
    satname:
    COSMOS 1932
    intDesignator:
    1988-019A
    launchDate:
    1988-03-14
    satlat:
    62.9094
    satlng:
    12.0056
    satalt:
    986.1553
  21. satid:
    19451
    satname:
    SL-8 DEB
    intDesignator:
    1988-016K
    launchDate:
    1988-03-11
    satlat:
    68.4377
    satlng:
    5.1027
    satalt:
    1647.7132
  22. satid:
    19807
    satname:
    MOLNIYA 1-75
    intDesignator:
    1989-014A
    launchDate:
    1989-02-15
    satlat:
    61.7253
    satlng:
    -44.8893
    satalt:
    30291.4022
  23. satid:
    20030
    satname:
    COSMOS 839 DEB *
    intDesignator:
    1976-067BU
    launchDate:
    1976-07-08
    satlat:
    62.6414
    satlng:
    12.78
    satalt:
    1091.1691
  24. satid:
    20061
    satname:
    NAVSTAR 14 (USA 38)
    intDesignator:
    1989-044A
    launchDate:
    1989-06-10
    satlat:
    49.3611
    satlng:
    10.6224
    satalt:
    21336.272
  25. satid:
    21029
    satname:
    COSMOS 2115
    intDesignator:
    1990-114B
    launchDate:
    1990-12-22
    satlat:
    69.085
    satlng:
    9.1968
    satalt:
    1422.5472
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.