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-21T09:04:52Z in 0.847 seconds.

info:
category:
ANY
transactionscount:
95
satcount:
133
above:

25 results

  1. satid:
    629
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014G
    launchDate:
    1963-05-09
    satlat:
    50.5136
    satlng:
    16.693
    satalt:
    3662.3002
  2. satid:
    702
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014H
    launchDate:
    1963-05-09
    satlat:
    56.5662
    satlng:
    15.9496
    satalt:
    3687.2053
  3. satid:
    836
    satname:
    OPS 3662 (VELA 3)
    intDesignator:
    1964-040A
    launchDate:
    1964-07-17
    satlat:
    50.3419
    satlng:
    13.9969
    satalt:
    153609.9926
  4. satid:
    3244
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014BJ
    launchDate:
    1963-05-09
    satlat:
    52.4795
    satlng:
    20.2301
    satalt:
    3644.3253
  5. satid:
    5967
    satname:
    THORAD AGENA D DEB *
    intDesignator:
    1970-025MQ
    launchDate:
    1970-04-08
    satlat:
    59.5657
    satlng:
    8.46
    satalt:
    1257.6267
  6. satid:
    7005
    satname:
    COSMOS 626
    intDesignator:
    1973-108A
    launchDate:
    1973-12-27
    satlat:
    56.2826
    satlng:
    8.4836
    satalt:
    941.8675
  7. satid:
    8195
    satname:
    MOLNIYA 2-14
    intDesignator:
    1975-081A
    launchDate:
    1975-09-09
    satlat:
    62.9004
    satlng:
    -32.5116
    satalt:
    38163.7429
  8. satid:
    8561
    satname:
    THORAD DELTA 1 DEB
    intDesignator:
    1974-089CY
    launchDate:
    1974-11-15
    satlat:
    62.487
    satlng:
    13.3333
    satalt:
    1449.5553
  9. satid:
    8601
    satname:
    MOLNIYA 1-32
    intDesignator:
    1976-006A
    launchDate:
    1976-01-22
    satlat:
    47.6572
    satlng:
    -10.9438
    satalt:
    23611.351
  10. satid:
    8822
    satname:
    LAGEOS 1 AKM
    intDesignator:
    1976-039C
    launchDate:
    1976-05-04
    satlat:
    62.9003
    satlng:
    16.6441
    satalt:
    5953.0885
  11. satid:
    9973
    satname:
    COSMOS 252 DEB
    intDesignator:
    1968-097DV
    launchDate:
    1968-11-01
    satlat:
    55.7396
    satlng:
    9.0278
    satalt:
    1394.6592
  12. satid:
    10089
    satname:
    SL-6 R/B(2)
    intDesignator:
    1977-047D
    launchDate:
    1977-06-16
    satlat:
    66.3052
    satlng:
    27.8177
    satalt:
    31440.9527
  13. satid:
    10150
    satname:
    COSMOS 931
    intDesignator:
    1977-068A
    launchDate:
    1977-07-20
    satlat:
    70.8684
    satlng:
    -14.8332
    satalt:
    24090.9991
  14. satid:
    10453
    satname:
    COSMOS 839 DEB
    intDesignator:
    1976-067AE
    launchDate:
    1976-07-08
    satlat:
    65.261
    satlng:
    12.1171
    satalt:
    2051.5125
  15. satid:
    11705
    satname:
    ATLAS 35F R/B
    intDesignator:
    1980-011B
    launchDate:
    1980-02-09
    satlat:
    64.4004
    satlng:
    47.6895
    satalt:
    14068.0162
  16. satid:
    11909
    satname:
    SL-6 R/B(2)
    intDesignator:
    1980-063D
    launchDate:
    1980-07-18
    satlat:
    57.5683
    satlng:
    -34.5782
    satalt:
    37284.5392
  17. satid:
    12384
    satname:
    SL-6 R/B(2)
    intDesignator:
    1981-031D
    launchDate:
    1981-03-31
    satlat:
    51.5526
    satlng:
    45.0435
    satalt:
    19749.3353
  18. satid:
    12816
    satname:
    COSMOS 1124 DEB
    intDesignator:
    1979-077F
    launchDate:
    1979-08-28
    satlat:
    43.0678
    satlng:
    35.6977
    satalt:
    18010.6604
  19. satid:
    12862
    satname:
    COSMOS 970 DEB
    intDesignator:
    1977-121AQ
    launchDate:
    1977-12-21
    satlat:
    60.9663
    satlng:
    12.8539
    satalt:
    790.768
  20. satid:
    12984
    satname:
    COSMOS 1247 DEB
    intDesignator:
    1981-016F
    launchDate:
    1981-02-19
    satlat:
    63.5388
    satlng:
    -34.9979
    satalt:
    21912.1966
  21. satid:
    13080
    satname:
    COSMOS 1341
    intDesignator:
    1982-016A
    launchDate:
    1982-03-03
    satlat:
    38.4011
    satlng:
    -6.2893
    satalt:
    33125.4632
  22. satid:
    13603
    satname:
    COSMOS 1413 (GLONASS)
    intDesignator:
    1982-100A
    launchDate:
    1982-10-12
    satlat:
    64.9973
    satlng:
    -13.2169
    satalt:
    19070.6524
  23. satid:
    13875
    satname:
    MOLNIYA 3-20
    intDesignator:
    1983-015A
    launchDate:
    1983-03-11
    satlat:
    62.0318
    satlng:
    55.8931
    satalt:
    39108.5912
  24. satid:
    13959
    satname:
    COSMOS 1030 DEB
    intDesignator:
    1978-083G
    launchDate:
    1978-09-06
    satlat:
    48.5965
    satlng:
    26.6575
    satalt:
    32313.4931
  25. satid:
    14189
    satname:
    OPS 9794 (NAVSTAR 8)
    intDesignator:
    1983-072A
    launchDate:
    1983-07-14
    satlat:
    56.2122
    satlng:
    31.2071
    satalt:
    20635.9934
limit:
25
offset:
0
returned:
25
has_more_results:
yes
next_offset:
25
Show all fields in HTML
info:
category:
ANY
transactionscount:
95
satcount:
133
above:

25 results

  1. satid:
    629
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014G
    launchDate:
    1963-05-09
    satlat:
    50.5136
    satlng:
    16.693
    satalt:
    3662.3002
  2. satid:
    702
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014H
    launchDate:
    1963-05-09
    satlat:
    56.5662
    satlng:
    15.9496
    satalt:
    3687.2053
  3. satid:
    836
    satname:
    OPS 3662 (VELA 3)
    intDesignator:
    1964-040A
    launchDate:
    1964-07-17
    satlat:
    50.3419
    satlng:
    13.9969
    satalt:
    153609.9926
  4. satid:
    3244
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014BJ
    launchDate:
    1963-05-09
    satlat:
    52.4795
    satlng:
    20.2301
    satalt:
    3644.3253
  5. satid:
    5967
    satname:
    THORAD AGENA D DEB *
    intDesignator:
    1970-025MQ
    launchDate:
    1970-04-08
    satlat:
    59.5657
    satlng:
    8.46
    satalt:
    1257.6267
  6. satid:
    7005
    satname:
    COSMOS 626
    intDesignator:
    1973-108A
    launchDate:
    1973-12-27
    satlat:
    56.2826
    satlng:
    8.4836
    satalt:
    941.8675
  7. satid:
    8195
    satname:
    MOLNIYA 2-14
    intDesignator:
    1975-081A
    launchDate:
    1975-09-09
    satlat:
    62.9004
    satlng:
    -32.5116
    satalt:
    38163.7429
  8. satid:
    8561
    satname:
    THORAD DELTA 1 DEB
    intDesignator:
    1974-089CY
    launchDate:
    1974-11-15
    satlat:
    62.487
    satlng:
    13.3333
    satalt:
    1449.5553
  9. satid:
    8601
    satname:
    MOLNIYA 1-32
    intDesignator:
    1976-006A
    launchDate:
    1976-01-22
    satlat:
    47.6572
    satlng:
    -10.9438
    satalt:
    23611.351
  10. satid:
    8822
    satname:
    LAGEOS 1 AKM
    intDesignator:
    1976-039C
    launchDate:
    1976-05-04
    satlat:
    62.9003
    satlng:
    16.6441
    satalt:
    5953.0885
  11. satid:
    9973
    satname:
    COSMOS 252 DEB
    intDesignator:
    1968-097DV
    launchDate:
    1968-11-01
    satlat:
    55.7396
    satlng:
    9.0278
    satalt:
    1394.6592
  12. satid:
    10089
    satname:
    SL-6 R/B(2)
    intDesignator:
    1977-047D
    launchDate:
    1977-06-16
    satlat:
    66.3052
    satlng:
    27.8177
    satalt:
    31440.9527
  13. satid:
    10150
    satname:
    COSMOS 931
    intDesignator:
    1977-068A
    launchDate:
    1977-07-20
    satlat:
    70.8684
    satlng:
    -14.8332
    satalt:
    24090.9991
  14. satid:
    10453
    satname:
    COSMOS 839 DEB
    intDesignator:
    1976-067AE
    launchDate:
    1976-07-08
    satlat:
    65.261
    satlng:
    12.1171
    satalt:
    2051.5125
  15. satid:
    11705
    satname:
    ATLAS 35F R/B
    intDesignator:
    1980-011B
    launchDate:
    1980-02-09
    satlat:
    64.4004
    satlng:
    47.6895
    satalt:
    14068.0162
  16. satid:
    11909
    satname:
    SL-6 R/B(2)
    intDesignator:
    1980-063D
    launchDate:
    1980-07-18
    satlat:
    57.5683
    satlng:
    -34.5782
    satalt:
    37284.5392
  17. satid:
    12384
    satname:
    SL-6 R/B(2)
    intDesignator:
    1981-031D
    launchDate:
    1981-03-31
    satlat:
    51.5526
    satlng:
    45.0435
    satalt:
    19749.3353
  18. satid:
    12816
    satname:
    COSMOS 1124 DEB
    intDesignator:
    1979-077F
    launchDate:
    1979-08-28
    satlat:
    43.0678
    satlng:
    35.6977
    satalt:
    18010.6604
  19. satid:
    12862
    satname:
    COSMOS 970 DEB
    intDesignator:
    1977-121AQ
    launchDate:
    1977-12-21
    satlat:
    60.9663
    satlng:
    12.8539
    satalt:
    790.768
  20. satid:
    12984
    satname:
    COSMOS 1247 DEB
    intDesignator:
    1981-016F
    launchDate:
    1981-02-19
    satlat:
    63.5388
    satlng:
    -34.9979
    satalt:
    21912.1966
  21. satid:
    13080
    satname:
    COSMOS 1341
    intDesignator:
    1982-016A
    launchDate:
    1982-03-03
    satlat:
    38.4011
    satlng:
    -6.2893
    satalt:
    33125.4632
  22. satid:
    13603
    satname:
    COSMOS 1413 (GLONASS)
    intDesignator:
    1982-100A
    launchDate:
    1982-10-12
    satlat:
    64.9973
    satlng:
    -13.2169
    satalt:
    19070.6524
  23. satid:
    13875
    satname:
    MOLNIYA 3-20
    intDesignator:
    1983-015A
    launchDate:
    1983-03-11
    satlat:
    62.0318
    satlng:
    55.8931
    satalt:
    39108.5912
  24. satid:
    13959
    satname:
    COSMOS 1030 DEB
    intDesignator:
    1978-083G
    launchDate:
    1978-09-06
    satlat:
    48.5965
    satlng:
    26.6575
    satalt:
    32313.4931
  25. satid:
    14189
    satname:
    OPS 9794 (NAVSTAR 8)
    intDesignator:
    1983-072A
    launchDate:
    1983-07-14
    satlat:
    56.2122
    satlng:
    31.2071
    satalt:
    20635.9934
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.