Allemannsdata Wiki
Manual search

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-27T22:16:06Z in 0.905 seconds.

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

25 results

  1. satid:
    2431
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014AC
    launchDate:
    1963-05-09
    satlat:
    57.6936
    satlng:
    18.6461
    satalt:
    3403.9412
  2. satid:
    3244
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014BJ
    launchDate:
    1963-05-09
    satlat:
    63.7786
    satlng:
    18.8976
    satalt:
    3671.4468
  3. satid:
    4214
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1969-082CD
    launchDate:
    1969-09-30
    satlat:
    55.1657
    satlng:
    4.9629
    satalt:
    783.4516
  4. satid:
    4841
    satname:
    DELTA 1 DEB
    intDesignator:
    1968-055D
    launchDate:
    1968-07-04
    satlat:
    55.7484
    satlng:
    -4.9054
    satalt:
    5740.3315
  5. satid:
    5000
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025HW
    launchDate:
    1970-04-08
    satlat:
    57.6849
    satlng:
    0.323
    satalt:
    1039.3515
  6. satid:
    7629
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-007D
    launchDate:
    1975-01-30
    satlat:
    54.1218
    satlng:
    34.2515
    satalt:
    33903.7101
  7. satid:
    8177
    satname:
    THORAD DELTA 1 DEB
    intDesignator:
    1974-089AT
    launchDate:
    1974-11-15
    satlat:
    58.9862
    satlng:
    8.205
    satalt:
    1701.6713
  8. satid:
    9271
    satname:
    TITAN 34B AGENA R/B
    intDesignator:
    1976-080B
    launchDate:
    1976-08-06
    satlat:
    53.9406
    satlng:
    36.3579
    satalt:
    29707.9314
  9. satid:
    9896
    satname:
    COSMOS 862 DEB
    intDesignator:
    1976-105N
    launchDate:
    1976-10-22
    satlat:
    62.3563
    satlng:
    17.2811
    satalt:
    24948.0162
  10. satid:
    10715
    satname:
    DELTA 1 DEB
    intDesignator:
    1976-077AL
    launchDate:
    1976-07-29
    satlat:
    62.3159
    satlng:
    15.2071
    satalt:
    1500.1306
  11. satid:
    10893
    satname:
    OPS 5112 (NAVSTAR 2)
    intDesignator:
    1978-047A
    launchDate:
    1978-05-13
    satlat:
    55.5201
    satlng:
    -22.8598
    satalt:
    18786.1377
  12. satid:
    11079
    satname:
    SL-6 R/B(2)
    intDesignator:
    1978-095E
    launchDate:
    1978-10-13
    satlat:
    63.2812
    satlng:
    22.6
    satalt:
    35369.3604
  13. satid:
    12529
    satname:
    DELTA 1 DEB
    intDesignator:
    1976-077DJ
    launchDate:
    1976-07-29
    satlat:
    60.5195
    satlng:
    14.0355
    satalt:
    1706.528
  14. satid:
    13882
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-015E
    launchDate:
    1983-03-11
    satlat:
    43.8019
    satlng:
    15.9938
    satalt:
    23816.1957
  15. satid:
    13897
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-019D
    launchDate:
    1983-03-16
    satlat:
    51.9405
    satlng:
    -11.615
    satalt:
    33439.5838
  16. satid:
    14592
    satname:
    COSMOS 1521 (GLONASS)
    intDesignator:
    1983-127C
    launchDate:
    1983-12-29
    satlat:
    64.8927
    satlng:
    50.3892
    satalt:
    19134.0836
  17. satid:
    15223
    satname:
    SL-6 R/B(2)
    intDesignator:
    1984-089D
    launchDate:
    1984-08-24
    satlat:
    60.6922
    satlng:
    14.3049
    satalt:
    39010.0415
  18. satid:
    15266
    satname:
    SL-12 R/B(AUX MOTOR)
    intDesignator:
    1984-095H
    launchDate:
    1984-09-04
    satlat:
    52.0562
    satlng:
    2.3693
    satalt:
    12147.3863
  19. satid:
    15429
    satname:
    MOLNIYA 1-63
    intDesignator:
    1984-124A
    launchDate:
    1984-12-14
    satlat:
    47.4043
    satlng:
    27.6522
    satalt:
    31555.6638
  20. satid:
    15741
    satname:
    SL-6 R/B(2)
    intDesignator:
    1985-040D
    launchDate:
    1985-05-29
    satlat:
    53.9542
    satlng:
    -21.5744
    satalt:
    37025.8308
  21. satid:
    16854
    satname:
    SL-6 R/B(2)
    intDesignator:
    1986-050D
    launchDate:
    1986-07-05
    satlat:
    65.1133
    satlng:
    26.8278
    satalt:
    8500.802
  22. satid:
    18602
    satname:
    COSMOS 249 DEB
    intDesignator:
    1968-091DG
    launchDate:
    1968-10-20
    satlat:
    60.4823
    satlng:
    12.2166
    satalt:
    1679.9366
  23. satid:
    19059
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014EG
    launchDate:
    1963-05-09
    satlat:
    60.9914
    satlng:
    12.1833
    satalt:
    3670.4492
  24. satid:
    19169
    satname:
    SL-12 R/B(AUX MOTOR)
    intDesignator:
    1988-043G
    launchDate:
    1988-05-21
    satlat:
    65.42
    satlng:
    -18.8312
    satalt:
    13428.7164
  25. satid:
    19196
    satname:
    SL-14 R/B
    intDesignator:
    1988-046B
    launchDate:
    1988-05-30
    satlat:
    63.4392
    satlng:
    3.6809
    satalt:
    1498.3716
limit:
25
offset:
0
returned:
25
has_more_results:
yes
truncated:
yes
next_offset:
25
Show all fields in HTML
info:
category:
ANY
transactionscount:
100
satcount:
130
above:

25 results

  1. satid:
    2431
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014AC
    launchDate:
    1963-05-09
    satlat:
    57.6936
    satlng:
    18.6461
    satalt:
    3403.9412
  2. satid:
    3244
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014BJ
    launchDate:
    1963-05-09
    satlat:
    63.7786
    satlng:
    18.8976
    satalt:
    3671.4468
  3. satid:
    4214
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1969-082CD
    launchDate:
    1969-09-30
    satlat:
    55.1657
    satlng:
    4.9629
    satalt:
    783.4516
  4. satid:
    4841
    satname:
    DELTA 1 DEB
    intDesignator:
    1968-055D
    launchDate:
    1968-07-04
    satlat:
    55.7484
    satlng:
    -4.9054
    satalt:
    5740.3315
  5. satid:
    5000
    satname:
    THORAD AGENA D DEB
    intDesignator:
    1970-025HW
    launchDate:
    1970-04-08
    satlat:
    57.6849
    satlng:
    0.323
    satalt:
    1039.3515
  6. satid:
    7629
    satname:
    SL-6 R/B(2)
    intDesignator:
    1975-007D
    launchDate:
    1975-01-30
    satlat:
    54.1218
    satlng:
    34.2515
    satalt:
    33903.7101
  7. satid:
    8177
    satname:
    THORAD DELTA 1 DEB
    intDesignator:
    1974-089AT
    launchDate:
    1974-11-15
    satlat:
    58.9862
    satlng:
    8.205
    satalt:
    1701.6713
  8. satid:
    9271
    satname:
    TITAN 34B AGENA R/B
    intDesignator:
    1976-080B
    launchDate:
    1976-08-06
    satlat:
    53.9406
    satlng:
    36.3579
    satalt:
    29707.9314
  9. satid:
    9896
    satname:
    COSMOS 862 DEB
    intDesignator:
    1976-105N
    launchDate:
    1976-10-22
    satlat:
    62.3563
    satlng:
    17.2811
    satalt:
    24948.0162
  10. satid:
    10715
    satname:
    DELTA 1 DEB
    intDesignator:
    1976-077AL
    launchDate:
    1976-07-29
    satlat:
    62.3159
    satlng:
    15.2071
    satalt:
    1500.1306
  11. satid:
    10893
    satname:
    OPS 5112 (NAVSTAR 2)
    intDesignator:
    1978-047A
    launchDate:
    1978-05-13
    satlat:
    55.5201
    satlng:
    -22.8598
    satalt:
    18786.1377
  12. satid:
    11079
    satname:
    SL-6 R/B(2)
    intDesignator:
    1978-095E
    launchDate:
    1978-10-13
    satlat:
    63.2812
    satlng:
    22.6
    satalt:
    35369.3604
  13. satid:
    12529
    satname:
    DELTA 1 DEB
    intDesignator:
    1976-077DJ
    launchDate:
    1976-07-29
    satlat:
    60.5195
    satlng:
    14.0355
    satalt:
    1706.528
  14. satid:
    13882
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-015E
    launchDate:
    1983-03-11
    satlat:
    43.8019
    satlng:
    15.9938
    satalt:
    23816.1957
  15. satid:
    13897
    satname:
    SL-6 R/B(2)
    intDesignator:
    1983-019D
    launchDate:
    1983-03-16
    satlat:
    51.9405
    satlng:
    -11.615
    satalt:
    33439.5838
  16. satid:
    14592
    satname:
    COSMOS 1521 (GLONASS)
    intDesignator:
    1983-127C
    launchDate:
    1983-12-29
    satlat:
    64.8927
    satlng:
    50.3892
    satalt:
    19134.0836
  17. satid:
    15223
    satname:
    SL-6 R/B(2)
    intDesignator:
    1984-089D
    launchDate:
    1984-08-24
    satlat:
    60.6922
    satlng:
    14.3049
    satalt:
    39010.0415
  18. satid:
    15266
    satname:
    SL-12 R/B(AUX MOTOR)
    intDesignator:
    1984-095H
    launchDate:
    1984-09-04
    satlat:
    52.0562
    satlng:
    2.3693
    satalt:
    12147.3863
  19. satid:
    15429
    satname:
    MOLNIYA 1-63
    intDesignator:
    1984-124A
    launchDate:
    1984-12-14
    satlat:
    47.4043
    satlng:
    27.6522
    satalt:
    31555.6638
  20. satid:
    15741
    satname:
    SL-6 R/B(2)
    intDesignator:
    1985-040D
    launchDate:
    1985-05-29
    satlat:
    53.9542
    satlng:
    -21.5744
    satalt:
    37025.8308
  21. satid:
    16854
    satname:
    SL-6 R/B(2)
    intDesignator:
    1986-050D
    launchDate:
    1986-07-05
    satlat:
    65.1133
    satlng:
    26.8278
    satalt:
    8500.802
  22. satid:
    18602
    satname:
    COSMOS 249 DEB
    intDesignator:
    1968-091DG
    launchDate:
    1968-10-20
    satlat:
    60.4823
    satlng:
    12.2166
    satalt:
    1679.9366
  23. satid:
    19059
    satname:
    WESTFORD NEEDLES
    intDesignator:
    1963-014EG
    launchDate:
    1963-05-09
    satlat:
    60.9914
    satlng:
    12.1833
    satalt:
    3670.4492
  24. satid:
    19169
    satname:
    SL-12 R/B(AUX MOTOR)
    intDesignator:
    1988-043G
    launchDate:
    1988-05-21
    satlat:
    65.42
    satlng:
    -18.8312
    satalt:
    13428.7164
  25. satid:
    19196
    satname:
    SL-14 R/B
    intDesignator:
    1988-046B
    launchDate:
    1988-05-30
    satlat:
    63.4392
    satlng:
    3.6809
    satalt:
    1498.3716
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.

AI agent? Read the complete navigation and programming guide.