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-23T16:05:47Z in 1.729 seconds.

info:
category:
ANY
transactionscount:
69
satcount:
139
above:

25 results

  1. satid:
    2362
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014M
    launchDate:
    1963-05-09
    satlat:
    71.9034
    satlng:
    67.0131
    satalt:
    5890.7141
  2. satid:
    4211
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1969-082CA
    launchDate:
    1969-09-30
    satlat:
    70.0907
    satlng:
    34.2357
    satalt:
    878.9813
  3. satid:
    4613
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025R
    launchDate:
    1970-04-08
    satlat:
    71.8187
    satlng:
    28.3183
    satalt:
    875.1427
  4. satid:
    4645
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025AD
    launchDate:
    1970-04-08
    satlat:
    71.6007
    satlng:
    30.5923
    satalt:
    1147.3301
  5. satid:
    4819
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025EA
    launchDate:
    1970-04-08
    satlat:
    74.0541
    satlng:
    22.4645
    satalt:
    769.2361
  6. satid:
    6236
    satname:
    OSCAR 6
    intDesignator:
    1972-082B
    launchDate:
    1972-10-15
    satlat:
    65.8053
    satlng:
    18.9607
    satalt:
    1462.96
  7. satid:
    7016
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086G
    launchDate:
    1973-11-06
    satlat:
    78.168
    satlng:
    37.933
    satalt:
    2254.5008
  8. satid:
    7060
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086BC
    launchDate:
    1973-11-06
    satlat:
    66.3339
    satlng:
    17.7081
    satalt:
    1512.0895
  9. satid:
    7094
    satname:
    COSMOS 628
    intDesignator:
    1974-001A
    launchDate:
    1974-01-17
    satlat:
    73.8359
    satlng:
    19.6976
    satalt:
    1004.0208
  10. satid:
    7149
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086DP
    launchDate:
    1973-11-06
    satlat:
    76.92
    satlng:
    23.8303
    satalt:
    1516.1227
  11. satid:
    7349
    satname:
    COSMOS 663
    intDesignator:
    1974-048A
    launchDate:
    1974-06-27
    satlat:
    72.39
    satlng:
    14.9298
    satalt:
    1002.0582
  12. satid:
    7800
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-036D
    launchDate:
    1975-04-29
    satlat:
    58.2766
    satlng:
    17.5545
    satalt:
    37906.7104
  13. satid:
    8561
    satname:
    THORAD DELTA 1 DEB
    intDesignator:
    1974-089CY
    launchDate:
    1974-11-15
    satlat:
    74.2681
    satlng:
    19.0483
    satalt:
    1419.3795
  14. satid:
    8601
    satname:
    MOLNIYA 1-32
    intDesignator:
    1976-006A
    launchDate:
    1976-01-22
    satlat:
    50.4055
    satlng:
    24.5561
    satalt:
    30810.0962
  15. satid:
    10485
    satname:
    SL-6 R/B(2)
    intDesignator:
    1977-105E
    launchDate:
    1977-10-28
    satlat:
    62.7724
    satlng:
    68.6509
    satalt:
    38883.6008
  16. satid:
    10864
    satname:
    DELTA 1 DEB
    intDesignator:
    1976-077CS
    launchDate:
    1976-07-29
    satlat:
    75.0776
    satlng:
    34.448
    satalt:
    1930.6882
  17. satid:
    11705
    satname:
    ATLAS 35F R/B
    intDesignator:
    1980-011B
    launchDate:
    1980-02-09
    satlat:
    58.415
    satlng:
    22.9028
    satalt:
    11502.3504
  18. satid:
    12170
    satname:
    DELTA 1 DEB
    intDesignator:
    1978-026K
    launchDate:
    1978-03-05
    satlat:
    71.8957
    satlng:
    29.9984
    satalt:
    807.0423
  19. satid:
    12250
    satname:
    DELTA 1 DEB
    intDesignator:
    1978-026CT
    launchDate:
    1978-03-05
    satlat:
    73.0864
    satlng:
    27.5713
    satalt:
    797.3695
  20. satid:
    12262
    satname:
    DELTA 1 DEB
    intDesignator:
    1978-026DF
    launchDate:
    1978-03-05
    satlat:
    74.5987
    satlng:
    27.7364
    satalt:
    900.0337
  21. satid:
    12857
    satname:
    TANSEI 3 DEB
    intDesignator:
    1977-012H
    launchDate:
    1977-02-19
    satlat:
    66.1483
    satlng:
    34.2805
    satalt:
    1590.144
  22. satid:
    13002
    satname:
    RADIO 6
    intDesignator:
    1981-120F
    launchDate:
    1981-12-17
    satlat:
    65.5173
    satlng:
    16.8193
    satalt:
    1659.8776
  23. satid:
    13124
    satname:
    COSMOS 1348
    intDesignator:
    1982-029A
    launchDate:
    1982-04-07
    satlat:
    62.7866
    satlng:
    38.3595
    satalt:
    26307.4948
  24. satid:
    13882
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-015E
    launchDate:
    1983-03-11
    satlat:
    61.8406
    satlng:
    46.3977
    satalt:
    39461.4162
  25. satid:
    13897
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-019D
    launchDate:
    1983-03-16
    satlat:
    60.7558
    satlng:
    13.7364
    satalt:
    34460.8937
limit:
25
offset:
0
returned:
25
has_more_results:
yes
truncated:
yes
next_offset:
25
Show all fields in HTML
info:
category:
ANY
transactionscount:
69
satcount:
139
above:

25 results

  1. satid:
    2362
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014M
    launchDate:
    1963-05-09
    satlat:
    71.9034
    satlng:
    67.0131
    satalt:
    5890.7141
  2. satid:
    4211
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1969-082CA
    launchDate:
    1969-09-30
    satlat:
    70.0907
    satlng:
    34.2357
    satalt:
    878.9813
  3. satid:
    4613
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025R
    launchDate:
    1970-04-08
    satlat:
    71.8187
    satlng:
    28.3183
    satalt:
    875.1427
  4. satid:
    4645
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025AD
    launchDate:
    1970-04-08
    satlat:
    71.6007
    satlng:
    30.5923
    satalt:
    1147.3301
  5. satid:
    4819
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025EA
    launchDate:
    1970-04-08
    satlat:
    74.0541
    satlng:
    22.4645
    satalt:
    769.2361
  6. satid:
    6236
    satname:
    OSCAR 6
    intDesignator:
    1972-082B
    launchDate:
    1972-10-15
    satlat:
    65.8053
    satlng:
    18.9607
    satalt:
    1462.96
  7. satid:
    7016
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086G
    launchDate:
    1973-11-06
    satlat:
    78.168
    satlng:
    37.933
    satalt:
    2254.5008
  8. satid:
    7060
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086BC
    launchDate:
    1973-11-06
    satlat:
    66.3339
    satlng:
    17.7081
    satalt:
    1512.0895
  9. satid:
    7094
    satname:
    COSMOS 628
    intDesignator:
    1974-001A
    launchDate:
    1974-01-17
    satlat:
    73.8359
    satlng:
    19.6976
    satalt:
    1004.0208
  10. satid:
    7149
    satname:
    DELTA 1 DEB
    intDesignator:
    1973-086DP
    launchDate:
    1973-11-06
    satlat:
    76.92
    satlng:
    23.8303
    satalt:
    1516.1227
  11. satid:
    7349
    satname:
    COSMOS 663
    intDesignator:
    1974-048A
    launchDate:
    1974-06-27
    satlat:
    72.39
    satlng:
    14.9298
    satalt:
    1002.0582
  12. satid:
    7800
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-036D
    launchDate:
    1975-04-29
    satlat:
    58.2766
    satlng:
    17.5545
    satalt:
    37906.7104
  13. satid:
    8561
    satname:
    THORAD DELTA 1 DEB
    intDesignator:
    1974-089CY
    launchDate:
    1974-11-15
    satlat:
    74.2681
    satlng:
    19.0483
    satalt:
    1419.3795
  14. satid:
    8601
    satname:
    MOLNIYA 1-32
    intDesignator:
    1976-006A
    launchDate:
    1976-01-22
    satlat:
    50.4055
    satlng:
    24.5561
    satalt:
    30810.0962
  15. satid:
    10485
    satname:
    SL-6 R/B(2)
    intDesignator:
    1977-105E
    launchDate:
    1977-10-28
    satlat:
    62.7724
    satlng:
    68.6509
    satalt:
    38883.6008
  16. satid:
    10864
    satname:
    DELTA 1 DEB
    intDesignator:
    1976-077CS
    launchDate:
    1976-07-29
    satlat:
    75.0776
    satlng:
    34.448
    satalt:
    1930.6882
  17. satid:
    11705
    satname:
    ATLAS 35F R/B
    intDesignator:
    1980-011B
    launchDate:
    1980-02-09
    satlat:
    58.415
    satlng:
    22.9028
    satalt:
    11502.3504
  18. satid:
    12170
    satname:
    DELTA 1 DEB
    intDesignator:
    1978-026K
    launchDate:
    1978-03-05
    satlat:
    71.8957
    satlng:
    29.9984
    satalt:
    807.0423
  19. satid:
    12250
    satname:
    DELTA 1 DEB
    intDesignator:
    1978-026CT
    launchDate:
    1978-03-05
    satlat:
    73.0864
    satlng:
    27.5713
    satalt:
    797.3695
  20. satid:
    12262
    satname:
    DELTA 1 DEB
    intDesignator:
    1978-026DF
    launchDate:
    1978-03-05
    satlat:
    74.5987
    satlng:
    27.7364
    satalt:
    900.0337
  21. satid:
    12857
    satname:
    TANSEI 3 DEB
    intDesignator:
    1977-012H
    launchDate:
    1977-02-19
    satlat:
    66.1483
    satlng:
    34.2805
    satalt:
    1590.144
  22. satid:
    13002
    satname:
    RADIO 6
    intDesignator:
    1981-120F
    launchDate:
    1981-12-17
    satlat:
    65.5173
    satlng:
    16.8193
    satalt:
    1659.8776
  23. satid:
    13124
    satname:
    COSMOS 1348
    intDesignator:
    1982-029A
    launchDate:
    1982-04-07
    satlat:
    62.7866
    satlng:
    38.3595
    satalt:
    26307.4948
  24. satid:
    13882
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-015E
    launchDate:
    1983-03-11
    satlat:
    61.8406
    satlng:
    46.3977
    satalt:
    39461.4162
  25. satid:
    13897
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-019D
    launchDate:
    1983-03-16
    satlat:
    60.7558
    satlng:
    13.7364
    satalt:
    34460.8937
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.