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-16T19:02:21Z in 1.063 seconds.

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

25 results

  1. satid:
    264
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1961-015CL
    launchDate:
    1961-06-29
    satlat:
    60.7389
    satlng:
    6.7643
    satalt:
    785.3615
  2. satid:
    426
    satname:
    THOR AGENA B R/B
    intDesignator:
    1962-049B
    launchDate:
    1962-09-29
    satlat:
    54.7861
    satlng:
    3.3974
    satalt:
    1024.1506
  3. satid:
    2861
    satname:
    SECOR 9 (EGRS 9)
    intDesignator:
    1967-065A
    launchDate:
    1967-06-29
    satlat:
    51.1877
    satlng:
    3.1192
    satalt:
    3845.3468
  4. satid:
    3975
    satname:
    DELTA 1 DEB
    intDesignator:
    1968-069F
    launchDate:
    1968-08-16
    satlat:
    59.9582
    satlng:
    12.8845
    satalt:
    1482.4389
  5. satid:
    4144
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1969-082N
    launchDate:
    1969-09-30
    satlat:
    58.2676
    satlng:
    13.0552
    satalt:
    702.1519
  6. satid:
    4749
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025CX
    launchDate:
    1970-04-08
    satlat:
    60.5849
    satlng:
    4.9064
    satalt:
    951.434
  7. satid:
    4843
    satname:
    OPS 0100 DEB *
    intDesignator:
    1967-034E
    launchDate:
    1967-04-14
    satlat:
    58.7843
    satlng:
    15.1897
    satalt:
    1051.6853
  8. satid:
    5903
    satname:
    OPS 5058 (DMSP 5B F2)
    intDesignator:
    1972-018A
    launchDate:
    1972-03-24
    satlat:
    55.7065
    satlng:
    11.0183
    satalt:
    780.9147
  9. satid:
    7629
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-007D
    launchDate:
    1975-01-30
    satlat:
    64.5866
    satlng:
    41.3864
    satalt:
    32635.1289
  10. satid:
    8612
    satname:
    COSMOS 796
    intDesignator:
    1976-008F
    launchDate:
    1976-01-28
    satlat:
    57.1829
    satlng:
    -3.2064
    satalt:
    1501.6274
  11. satid:
    9271
    satname:
    TITAN 34B AGENA R/B
    intDesignator:
    1976-080B
    launchDate:
    1976-08-06
    satlat:
    54.2514
    satlng:
    -32.5
    satalt:
    17791.9579
  12. satid:
    10893
    satname:
    OPS 5112 (NAVSTAR 2)
    intDesignator:
    1978-047A
    launchDate:
    1978-05-13
    satlat:
    61.8503
    satlng:
    32.832
    satalt:
    18983.3034
  13. satid:
    12827
    satname:
    SL-6 R/B(2)
    intDesignator:
    1981-088F
    launchDate:
    1981-09-11
    satlat:
    58.4951
    satlng:
    44.0172
    satalt:
    13430.9661
  14. satid:
    13764
    satname:
    COSMOS 1432
    intDesignator:
    1983-002D
    launchDate:
    1983-01-19
    satlat:
    62.765
    satlng:
    8.723
    satalt:
    1477.7805
  15. satid:
    14180
    satname:
    GB 3
    intDesignator:
    1983-056G
    launchDate:
    1983-06-09
    satlat:
    57.9268
    satlng:
    6.8933
    satalt:
    695.3546
  16. satid:
    14191
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-070D
    launchDate:
    1983-07-08
    satlat:
    54.2347
    satlng:
    -33.0015
    satalt:
    34414.4868
  17. satid:
    14511
    satname:
    COSMOS 970 DEB
    intDesignator:
    1977-121BJ
    launchDate:
    1977-12-21
    satlat:
    54.9367
    satlng:
    9.3689
    satalt:
    1083.1292
  18. satid:
    14894
    satname:
    SL-6 R/B(2)
    intDesignator:
    1984-033D
    launchDate:
    1984-04-04
    satlat:
    52.2293
    satlng:
    -7.1573
    satalt:
    31591.4156
  19. satid:
    14905
    satname:
    DELTA 1 DEB
    intDesignator:
    1976-077ET
    launchDate:
    1976-07-29
    satlat:
    59.6885
    satlng:
    6.5879
    satalt:
    1674.9801
  20. satid:
    15227
    satname:
    TITAN 34B R/B
    intDesignator:
    1984-091B
    launchDate:
    1984-08-28
    satlat:
    57.9541
    satlng:
    -25.9608
    satalt:
    32456.4179
  21. satid:
    15266
    satname:
    SL-12 R/B(AUX MOTOR)
    intDesignator:
    1984-095H
    launchDate:
    1984-09-04
    satlat:
    51.985
    satlng:
    22.8457
    satalt:
    10839.7975
  22. satid:
    15272
    satname:
    ATLAS 14E R/B
    intDesignator:
    1984-097B
    launchDate:
    1984-09-08
    satlat:
    57.6264
    satlng:
    1.6549
    satalt:
    15823.4482
  23. satid:
    15741
    satname:
    SL-6 R/B(2)
    intDesignator:
    1985-040D
    launchDate:
    1985-05-29
    satlat:
    60.3776
    satlng:
    27.801
    satalt:
    40398.9337
  24. satid:
    17328
    satname:
    MOLNIYA 3-31
    intDesignator:
    1987-008A
    launchDate:
    1987-01-22
    satlat:
    59.9173
    satlng:
    55.7358
    satalt:
    33549.4566
  25. satid:
    17369
    satname:
    COSMOS 1818
    intDesignator:
    1987-011A
    launchDate:
    1987-02-01
    satlat:
    57.2288
    satlng:
    1.7689
    satalt:
    806.5544
limit:
25
offset:
0
returned:
25
has_more_results:
yes
next_offset:
25
Show all fields in HTML
info:
category:
ANY
transactionscount:
100
satcount:
108
above:

25 results

  1. satid:
    264
    satname:
    THOR ABLESTAR DEB
    intDesignator:
    1961-015CL
    launchDate:
    1961-06-29
    satlat:
    60.7389
    satlng:
    6.7643
    satalt:
    785.3615
  2. satid:
    426
    satname:
    THOR AGENA B R/B
    intDesignator:
    1962-049B
    launchDate:
    1962-09-29
    satlat:
    54.7861
    satlng:
    3.3974
    satalt:
    1024.1506
  3. satid:
    2861
    satname:
    SECOR 9 (EGRS 9)
    intDesignator:
    1967-065A
    launchDate:
    1967-06-29
    satlat:
    51.1877
    satlng:
    3.1192
    satalt:
    3845.3468
  4. satid:
    3975
    satname:
    DELTA 1 DEB
    intDesignator:
    1968-069F
    launchDate:
    1968-08-16
    satlat:
    59.9582
    satlng:
    12.8845
    satalt:
    1482.4389
  5. satid:
    4144
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1969-082N
    launchDate:
    1969-09-30
    satlat:
    58.2676
    satlng:
    13.0552
    satalt:
    702.1519
  6. satid:
    4749
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025CX
    launchDate:
    1970-04-08
    satlat:
    60.5849
    satlng:
    4.9064
    satalt:
    951.434
  7. satid:
    4843
    satname:
    OPS 0100 DEB *
    intDesignator:
    1967-034E
    launchDate:
    1967-04-14
    satlat:
    58.7843
    satlng:
    15.1897
    satalt:
    1051.6853
  8. satid:
    5903
    satname:
    OPS 5058 (DMSP 5B F2)
    intDesignator:
    1972-018A
    launchDate:
    1972-03-24
    satlat:
    55.7065
    satlng:
    11.0183
    satalt:
    780.9147
  9. satid:
    7629
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-007D
    launchDate:
    1975-01-30
    satlat:
    64.5866
    satlng:
    41.3864
    satalt:
    32635.1289
  10. satid:
    8612
    satname:
    COSMOS 796
    intDesignator:
    1976-008F
    launchDate:
    1976-01-28
    satlat:
    57.1829
    satlng:
    -3.2064
    satalt:
    1501.6274
  11. satid:
    9271
    satname:
    TITAN 34B AGENA R/B
    intDesignator:
    1976-080B
    launchDate:
    1976-08-06
    satlat:
    54.2514
    satlng:
    -32.5
    satalt:
    17791.9579
  12. satid:
    10893
    satname:
    OPS 5112 (NAVSTAR 2)
    intDesignator:
    1978-047A
    launchDate:
    1978-05-13
    satlat:
    61.8503
    satlng:
    32.832
    satalt:
    18983.3034
  13. satid:
    12827
    satname:
    SL-6 R/B(2)
    intDesignator:
    1981-088F
    launchDate:
    1981-09-11
    satlat:
    58.4951
    satlng:
    44.0172
    satalt:
    13430.9661
  14. satid:
    13764
    satname:
    COSMOS 1432
    intDesignator:
    1983-002D
    launchDate:
    1983-01-19
    satlat:
    62.765
    satlng:
    8.723
    satalt:
    1477.7805
  15. satid:
    14180
    satname:
    GB 3
    intDesignator:
    1983-056G
    launchDate:
    1983-06-09
    satlat:
    57.9268
    satlng:
    6.8933
    satalt:
    695.3546
  16. satid:
    14191
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-070D
    launchDate:
    1983-07-08
    satlat:
    54.2347
    satlng:
    -33.0015
    satalt:
    34414.4868
  17. satid:
    14511
    satname:
    COSMOS 970 DEB
    intDesignator:
    1977-121BJ
    launchDate:
    1977-12-21
    satlat:
    54.9367
    satlng:
    9.3689
    satalt:
    1083.1292
  18. satid:
    14894
    satname:
    SL-6 R/B(2)
    intDesignator:
    1984-033D
    launchDate:
    1984-04-04
    satlat:
    52.2293
    satlng:
    -7.1573
    satalt:
    31591.4156
  19. satid:
    14905
    satname:
    DELTA 1 DEB
    intDesignator:
    1976-077ET
    launchDate:
    1976-07-29
    satlat:
    59.6885
    satlng:
    6.5879
    satalt:
    1674.9801
  20. satid:
    15227
    satname:
    TITAN 34B R/B
    intDesignator:
    1984-091B
    launchDate:
    1984-08-28
    satlat:
    57.9541
    satlng:
    -25.9608
    satalt:
    32456.4179
  21. satid:
    15266
    satname:
    SL-12 R/B(AUX MOTOR)
    intDesignator:
    1984-095H
    launchDate:
    1984-09-04
    satlat:
    51.985
    satlng:
    22.8457
    satalt:
    10839.7975
  22. satid:
    15272
    satname:
    ATLAS 14E R/B
    intDesignator:
    1984-097B
    launchDate:
    1984-09-08
    satlat:
    57.6264
    satlng:
    1.6549
    satalt:
    15823.4482
  23. satid:
    15741
    satname:
    SL-6 R/B(2)
    intDesignator:
    1985-040D
    launchDate:
    1985-05-29
    satlat:
    60.3776
    satlng:
    27.801
    satalt:
    40398.9337
  24. satid:
    17328
    satname:
    MOLNIYA 3-31
    intDesignator:
    1987-008A
    launchDate:
    1987-01-22
    satlat:
    59.9173
    satlng:
    55.7358
    satalt:
    33549.4566
  25. satid:
    17369
    satname:
    COSMOS 1818
    intDesignator:
    1987-011A
    launchDate:
    1987-02-01
    satlat:
    57.2288
    satlng:
    1.7689
    satalt:
    806.5544
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.