---
type: "firecrawl-provider"
description: "Current GP (general perturbations) orbital element sets from CelesTrak, the long-running public redistributor of US Space Force 18 SDS satellite tracking data: by NORAD catalog number, by name, by international designator (launch) or by CelesTrak group (stations, last-30-days, visual, gps-ops, weather and more). Each element set carries the CCSDS OMM keywords exactly as CelesTrak's JSON publishes them, the TLE lines when the catalog number fits the TLE format, the epoch and its age, and derived period, apogee and perigee."
use_when: "Current GP (general perturbations) orbital element sets from CelesTrak, the long-running public redistributor of US Space Force 18 SDS satellite tracking data: by NORAD catalog number, by name, by international designator (launch) or by CelesTrak group (stations, last-30-days, visual, gps-ops, weather and more). Each element set carries the CCSDS OMM keywords exactly as CelesTrak's JSON publishes them, the TLE lines when the catalog number fits the TLE format, the epoch and its age, and derived period, apogee and perigee."
categories: "Public records"
capabilities: 3
credits_per_call: 5
---
# CelesTrak GP orbital elements on Firecrawl Alexandria

Current GP (general perturbations) orbital element sets from CelesTrak, the long-running public redistributor of US Space Force 18 SDS satellite tracking data: by NORAD catalog number, by name, by international designator (launch) or by CelesTrak group (stations, last-30-days, visual, gps-ops, weather and more). Each element set carries the CCSDS OMM keywords exactly as CelesTrak's JSON publishes them, the TLE lines when the catalog number fits the TLE format, the epoch and its age, and derived period, apogee and perigee.

- Categories: Public records
- Category index: [Public records category](https://alexandria.firecrawl.dev/agents/categories/public-records)
- Provider key: `celestrak-org`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://www.firecrawl.dev/app/alexandria/celestrak-org)
- [OpenAPI spec](https://alexandria.firecrawl.dev/agents/providers/celestrak-org/openapi.json)

## Capabilities

- [Gp by catalog number](https://alexandria.firecrawl.dev/agents/providers/celestrak-org/satellites/gp_by_catalog_number): The current GP element set for one object by NORAD catalog number: OMM keywords (epoch, mean motion, eccentricity, inclination, RAAN, argument of perigee, mean anomaly, B*, mean motion derivatives, rev number), TLE lines for catalog numbers up to 99999, epoch age and derived period, apogee and perigee. Source: CelesTrak gp.php?CATNR=N (JSON, plus TLE). Data refreshes about every 2 hours (CelesTrak usage policy: download once per update); epoch_age_hours shows freshness. Objects cataloged since 2026-07-11 have 6-digit catalog numbers and no TLE, only OMM.
- [Gp group](https://alexandria.firecrawl.dev/agents/providers/celestrak-org/satellites/gp_group): Current GP element sets for one CelesTrak group, as listed on https://celestrak.org/NORAD/elements/: stations, last-30-days, visual, weather, noaa, goes, resource, sarsat, tdrss, geo, intelsat, ses, iridium-NEXT, oneweb, orbcomm, globalstar, amateur, gnss, gps-ops, glo-ops, galileo, beidou, sbas, science, geodetic, engineering, education, military, radar, cubesat and others. The very large active and starlink lists are refused because CelesTrak rate-limits them; search or look up by catalog number instead. Source: CelesTrak gp.php?GROUP= (JSON, plus TLE). Data refreshes about every 2 hours (CelesTrak usage policy: download once per update); epoch_age_hours shows freshness. Objects cataloged since 2026-07-11 have 6-digit catalog numbers and no TLE, only OMM.
- [Gp search](https://alexandria.firecrawl.dev/agents/providers/celestrak-org/satellites/gp_search): Search current GP element sets by object name (substring, case-insensitive, at least 3 characters) or by international designator: a launch (YYYY-NNN returns every tracked object from it) or one object (YYYY-NNNA). Returns up to limit element sets with OMM keywords, TLE lines where available and derived orbit size. Source: CelesTrak gp.php?NAME= or ?INTDES= (JSON, plus TLE). An empty element_sets list means CelesTrak tracks nothing matching. Data refreshes about every 2 hours (CelesTrak usage policy: download once per update); epoch_age_hours shows freshness. Objects cataloged since 2026-07-11 have 6-digit catalog numbers and no TLE, only OMM.

## 1. Choose this provider when

Current GP (general perturbations) orbital element sets from CelesTrak, the long-running public redistributor of US Space Force 18 SDS satellite tracking data: by NORAD catalog number, by name, by international designator (launch) or by CelesTrak group (stations, last-30-days, visual, gps-ops, weather and more). Each element set carries the CCSDS OMM keywords exactly as CelesTrak's JSON publishes them, the TLE lines when the catalog number fits the TLE format, the epoch and its age, and derived period, apogee and perigee.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "celestrak-org",
  "capability": "satellites/gp_by_catalog_number",
  "options": {
    "catalog_number": 25544
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `catalog_number` (number, required): NORAD catalog number, e.g. 25544 (ISS). Example: `10`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "celestrak-org",
    capability: "satellites/gp_by_catalog_number",
    options: {
      catalog_number: 25544,
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "celestrak-org",
  "capability": "satellites/gp_by_catalog_number",
  "options": {
    "catalog_number": 25544
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "celestrak-org",
    "capability": "satellites/gp_by_catalog_number",
    "options": {
      "catalog_number": 25544
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'celestrak-org/satellites/gp_by_catalog_number' \
  --options '{"catalog_number":25544}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "celestrak-org",
  "capability": "satellites/gp_by_catalog_number",
  "options": {
    "catalog_number": 25544
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "celestrak-org",
  "capability": "satellites/gp_by_catalog_number",
  "options": {
    "catalog_number": 25544
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "element_set": {
    "apogee_altitude_km": 423.8,
    "catalog_number": 25544,
    "epoch": "2026-11-10T04:12:02.822688Z",
    "epoch_age_hours": 14.47,
    "international_designator": "1998-067A",
    "name": "ISS (ZARYA)",
    "omm": {
      "ARG_OF_PERICENTER": 8.9462,
      "BSTAR": 0.0001757453,
      "CLASSIFICATION_TYPE": "U",
      "ECCENTRICITY": 0.00072923,
      "ELEMENT_SET_NO": 999,
      "EPHEMERIS_TYPE": 0,
      "EPOCH": "2026-11-10T04:12:02.822688",
      "INCLINATION": 51.6322,
      "MEAN_ANOMALY": 351.1656,
      "MEAN_MOTION": 15.49289712,
      "MEAN_MOTION_DDOT": 0,
      "MEAN_MOTION_DOT": 0.00009346,
      "NORAD_CAT_ID": 25544,
      "OBJECT_ID": "1998-067A",
      "OBJECT_NAME": "ISS (ZARYA)",
      "RA_OF_ASC_NODE": 297.6644,
      "REV_AT_EPOCH": 59438
    },
    "perigee_altitude_km": 413.8,
    "period_minutes": 92.946,
    "semi_major_axis_km": 6796.9,
    "tle": {
      "line0": "ISS (ZARYA)",
      "line1": "1 25544U 98067A   26314.17503267  .00009346  00000+0  17575-3 0  9996",
      "line2": "2 25544  51.6322 297.6644 0007292   8.9462 351.1656 15.49289712594382"
    },
    "tle_unavailable_reason": null
  },
  "observed_at_ms": 1794336000000,
  "source_url": "https://celestrak.org/NORAD/elements/gp.php?CATNR=25544&FORMAT=JSON"
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Gp by catalog number

- Capability: `satellites/gp_by_catalog_number`
- Description: The current GP element set for one object by NORAD catalog number: OMM keywords (epoch, mean motion, eccentricity, inclination, RAAN, argument of perigee, mean anomaly, B*, mean motion derivatives, rev number), TLE lines for catalog numbers up to 99999, epoch age and derived period, apogee and perigee. Source: CelesTrak gp.php?CATNR=N (JSON, plus TLE). Data refreshes about every 2 hours (CelesTrak usage policy: download once per update); epoch_age_hours shows freshness. Objects cataloged since 2026-07-11 have 6-digit catalog numbers and no TLE, only OMM.
- Instructions: You know the catalog number (25544 for the ISS) and need its latest orbit or TLE to propagate with SGP4 or plot a ground track. Find the number with gp_search.
- Cost: 5 credits per call
- Capability file: [Gp by catalog number](https://alexandria.firecrawl.dev/agents/providers/celestrak-org/satellites/gp_by_catalog_number)

Accepted options:
- `catalog_number` (number, required): NORAD catalog number, e.g. 25544 (ISS). Example: `10`

Response schema example:
```json
{
  "element_set": {
    "apogee_altitude_km": 423.8,
    "catalog_number": 25544,
    "epoch": "2026-11-10T04:12:02.822688Z",
    "epoch_age_hours": 14.47,
    "international_designator": "1998-067A",
    "name": "ISS (ZARYA)",
    "omm": {
      "ARG_OF_PERICENTER": 8.9462,
      "BSTAR": 0.0001757453,
      "CLASSIFICATION_TYPE": "U",
      "ECCENTRICITY": 0.00072923,
      "ELEMENT_SET_NO": 999,
      "EPHEMERIS_TYPE": 0,
      "EPOCH": "2026-11-10T04:12:02.822688",
      "INCLINATION": 51.6322,
      "MEAN_ANOMALY": 351.1656,
      "MEAN_MOTION": 15.49289712,
      "MEAN_MOTION_DDOT": 0,
      "MEAN_MOTION_DOT": 0.00009346,
      "NORAD_CAT_ID": 25544,
      "OBJECT_ID": "1998-067A",
      "OBJECT_NAME": "ISS (ZARYA)",
      "RA_OF_ASC_NODE": 297.6644,
      "REV_AT_EPOCH": 59438
    },
    "perigee_altitude_km": 413.8,
    "period_minutes": 92.946,
    "semi_major_axis_km": 6796.9,
    "tle": {
      "line0": "ISS (ZARYA)",
      "line1": "1 25544U 98067A   26314.17503267  .00009346  00000+0  17575-3 0  9996",
      "line2": "2 25544  51.6322 297.6644 0007292   8.9462 351.1656 15.49289712594382"
    },
    "tle_unavailable_reason": null
  },
  "observed_at_ms": 1794336000000,
  "source_url": "https://celestrak.org/NORAD/elements/gp.php?CATNR=25544&FORMAT=JSON"
}
```

### Gp group

- Capability: `satellites/gp_group`
- Description: Current GP element sets for one CelesTrak group, as listed on https://celestrak.org/NORAD/elements/: stations, last-30-days, visual, weather, noaa, goes, resource, sarsat, tdrss, geo, intelsat, ses, iridium-NEXT, oneweb, orbcomm, globalstar, amateur, gnss, gps-ops, glo-ops, galileo, beidou, sbas, science, geodetic, engineering, education, military, radar, cubesat and others. The very large active and starlink lists are refused because CelesTrak rate-limits them; search or look up by catalog number instead. Source: CelesTrak gp.php?GROUP= (JSON, plus TLE). Data refreshes about every 2 hours (CelesTrak usage policy: download once per update); epoch_age_hours shows freshness. Objects cataloged since 2026-07-11 have 6-digit catalog numbers and no TLE, only OMM.
- Instructions: All objects in a category at once: every space station, every launch of the last 30 days, the GPS constellation.
- Cost: 5 credits per call
- Capability file: [Gp group](https://alexandria.firecrawl.dev/agents/providers/celestrak-org/satellites/gp_group)

Accepted options:
- `group` (string, required): CelesTrak group name, e.g. stations, last-30-days, gps-ops. Pattern: ^\s*[A-Za-z0-9-]+\s*$. Example: `<group>`
- `limit` (number): Most element sets to return (default 100). Example: `100`

Response schema example:
```json
{
  "element_sets": [
    {
      "apogee_altitude_km": 423.8,
      "catalog_number": 25544,
      "epoch": "2026-11-10T04:12:02.822688Z",
      "epoch_age_hours": 14.47,
      "international_designator": "1998-067A",
      "name": "ISS (ZARYA)",
      "omm": {
        "ARG_OF_PERICENTER": 8.9462,
        "BSTAR": 0.0001757453,
        "CLASSIFICATION_TYPE": "U",
        "ECCENTRICITY": 0.00072923,
        "ELEMENT_SET_NO": 999,
        "EPHEMERIS_TYPE": 0,
        "EPOCH": "2026-11-10T04:12:02.822688",
        "INCLINATION": 51.6322,
        "MEAN_ANOMALY": 351.1656,
        "MEAN_MOTION": 15.49289712,
        "MEAN_MOTION_DDOT": 0,
        "MEAN_MOTION_DOT": 0.00009346,
        "NORAD_CAT_ID": 25544,
        "OBJECT_ID": "1998-067A",
        "OBJECT_NAME": "ISS (ZARYA)",
        "RA_OF_ASC_NODE": 297.6644,
        "REV_AT_EPOCH": 59438
      },
      "perigee_altitude_km": 413.8,
      "period_minutes": 92.946,
      "semi_major_axis_km": 6796.9,
      "tle": {
        "line0": "ISS (ZARYA)",
        "line1": "1 25544U 98067A   26314.17503267  .00009346  00000+0  17575-3 0  9996",
        "line2": "2 25544  51.6322 297.6644 0007292   8.9462 351.1656 15.49289712594382"
      },
      "tle_unavailable_reason": null
    },
    {
      "apogee_altitude_km": 423.8,
      "catalog_number": 36086,
      "epoch": "2026-11-10T04:12:02.822688Z",
      "epoch_age_hours": 14.47,
      "international_designator": "2009-060A",
      "name": "POISK",
      "omm": {
        "ARG_OF_PERICENTER": 8.9462,
        "BSTAR": 0.0001757453,
        "CLASSIFICATION_TYPE": "U",
        "ECCENTRICITY": 0.00072923,
        "ELEMENT_SET_NO": 999,
        "EPHEMERIS_TYPE": 0,
        "EPOCH": "2026-11-10T04:12:02.822688",
        "INCLINATION": 51.6322,
        "MEAN_ANOMALY": 351.1656,
        "MEAN_MOTION": 15.49289712,
        "MEAN_MOTION_DDOT": 0,
        "MEAN_MOTION_DOT": 0.00009346,
        "NORAD_CAT_ID": 36086,
        "OBJECT_ID": "2009-060A",
        "OBJECT_NAME": "POISK",
        "RA_OF_ASC_NODE": 297.6644,
        "REV_AT_EPOCH": 58676
      },
      "perigee_altitude_km": 413.8,
      "period_minutes": 92.946,
      "semi_major_axis_km": 6796.9,
      "tle": {
        "line0": "POISK",
        "line1": "1 36086U 09060A   26314.17503267  .00009346  00000+0  17575-3 0  9994",
        "line2": "2 36086  51.6322 297.6644 0007292   8.9462 351.1656 15.49289712586768"
      },
      "tle_unavailable_reason": null
    },
    {
      "apogee_altitude_km": 386,
      "catalog_number": 48274,
      "epoch": "2026-11-10T00:34:30.359136Z",
      "epoch_age_hours": 18.09,
      "international_designator": "2021-035A",
      "name": "CSS (TIANHE)",
      "omm": {
        "ARG_OF_PERICENTER": 284.6802,
        "BSTAR": 0.00025654553,
        "CLASSIFICATION_TYPE": "U",
        "ECCENTRICITY": 0.0004612,
        "ELEMENT_SET_NO": 999,
        "EPHEMERIS_TYPE": 0,
        "EPOCH": "2026-11-10T00:34:30.359136",
        "INCLINATION": 41.4671,
        "MEAN_ANOMALY": 75.3526,
        "MEAN_MOTION": 15.61635786,
        "MEAN_MOTION_DDOT": 0,
        "MEAN_MOTION_DOT": 0.00022456,
        "NORAD_CAT_ID": 48274,
        "OBJECT_ID": "2021-035A",
        "OBJECT_NAME": "CSS (TIANHE)",
        "RA_OF_ASC_NODE": 155.8173,
        "REV_AT_EPOCH": 31594
      },
      "perigee_altitude_km": 379.8,
      "period_minutes": 92.211,
      "semi_major_axis_km": 6761.1,
      "tle": {
        "line0": "CSS (TIANHE)",
        "line1": "1 48274U 21035A   26314.02396249  .00022456  00000+0  25655-3 0  9991",
        "line2": "2 48274  41.4671 155.8173 0004612 284.6802  75.3526 15.61635786315941"
      },
      "tle_unavailable_reason": null
    },
    {
      "apogee_altitude_km": 423.8,
      "catalog_number": 49044,
      "epoch": "2026-11-10T04:12:02.822688Z",
      "epoch_age_hours": 14.47,
      "international_designator": "2021-066A",
      "name": "ISS (NAUKA)",
      "omm": {
        "ARG_OF_PERICENTER": 8.9462,
        "BSTAR": 0.0001757453,
        "CLASSIFICATION_TYPE": "U",
        "ECCENTRICITY": 0.00072923,
        "ELEMENT_SET_NO": 999,
        "EPHEMERIS_TYPE": 0,
        "EPOCH": "2026-11-10T04:12:02.822688",
        "INCLINATION": 51.6322,
        "MEAN_ANOMALY": 351.1656,
        "MEAN_MOTION": 15.49289712,
        "MEAN_MOTION_DDOT": 0,
        "MEAN_MOTION_DOT": 0.00009346,
        "NORAD_CAT_ID": 49044,
        "OBJECT_ID": "2021-066A",
        "OBJECT_NAME": "ISS (NAUKA)",
        "RA_OF_ASC_NODE": 297.6644,
        "REV_AT_EPOCH": 58680
      },
      "perigee_altitude_km": 413.8,
      "period_minutes": 92.946,
      "semi_major_axis_km": 6796.9,
      "tle": {
        "line0": "ISS (NAUKA)",
        "line1": "1 49044U 21066A   26314.17503267  .00009346  00000+0  17575-3 0  9992",
        "line2": "2 49044  51.6322 297.6644 0007292   8.9462 351.1656 15.49289712586801"
      },
      "tle_unavailable_reason": null
    },
    {
      "apogee_altitude_km": 2209.8,
      "catalog_number": 49271,
      "epoch": "2026-11-09T23:07:34.704768Z",
      "epoch_age_hours": 19.54,
      "international_designator": "2011-037PF",
      "name": "FREGAT DEB",
      "omm": {
        "ARG_OF_PERICENTER": 251.5006,
        "BSTAR": 0.017223709,
        "CLASSIFICATION_TYPE": "U",
        "ECCENTRICITY": 0.09256747,
        "ELEMENT_SET_NO": 999,
        "EPHEMERIS_TYPE": 0,
        "EPOCH": "2026-11-09T23:07:34.704768",
        "INCLINATION": 51.6515,
        "MEAN_ANOMALY": 98.3176,
        "MEAN_MOTION": 12.45780234,
        "MEAN_MOTION_DDOT": 0,
        "MEAN_MOTION_DOT": 0.0001184,
        "NORAD_CAT_ID": 49271,
        "OBJECT_ID": "2011-037PF",
        "OBJECT_NAME": "FREGAT DEB",
        "RA_OF_ASC_NODE": 282.0865,
        "REV_AT_EPOCH": 24319
      },
      "perigee_altitude_km": 754.6,
      "period_minutes": 115.59,
      "semi_major_axis_km": 7860.3,
      "tle": {
        "line0": "FREGAT DEB",
        "line1": "1 49271U 11037PF  26313.96359612  .00011840  00000+0  17224-1 0  9991",
        "line2": "2 49271  51.6515 282.0865 0925674 251.5006  98.3176 12.45780234243190"
      },
      "tle_unavailable_reason": null
    },
    {
      "apogee_altitude_km": 386,
      "catalog_number": 53239,
      "epoch": "2026-11-10T00:34:30.359136Z",
      "epoch_age_hours": 18.09,
      "international_designator": "2022-085A",
      "name": "CSS (WENTIAN)",
      "omm": {
        "ARG_OF_PERICENTER": 284.6802,
        "BSTAR": 0.00025654553,
        "CLASSIFICATION_TYPE": "U",
        "ECCENTRICITY": 0.0004612,
        "ELEMENT_SET_NO": 999,
        "EPHEMERIS_TYPE": 0,
        "EPOCH": "2026-11-10T00:34:30.359136",
        "INCLINATION": 41.4671,
        "MEAN_ANOMALY": 75.3526,
        "MEAN_MOTION": 15.61635786,
        "MEAN_MOTION_DDOT": 0,
        "MEAN_MOTION_DOT": 0.00022456,
        "NORAD_CAT_ID": 53239,
        "OBJECT_ID": "2022-085A",
        "OBJECT_NAME": "CSS (WENTIAN)",
        "RA_OF_ASC_NODE": 155.8173,
        "REV_AT_EPOCH": 28823
      },
      "perigee_altitude_km": 379.8,
      "period_minutes": 92.211,
      "semi_major_axis_km": 6761.1,
      "tle": {
        "line0": "CSS (WENTIAN)",
        "line1": "1 53239U 22085A   26314.02396249  .00022456  00000+0  25655-3 0  9994",
        "line2": "2 53239  41.4671 155.8173 0004612 284.6802  75.3526 15.61635786288239"
      },
      "tle_unavailable_reason": null
    },
    {
      "apogee_altitude_km": 386,
      "catalog_number": 54216,
      "epoch": "2026-11-10T00:34:30.359136Z",
      "epoch_age_hours": 18.09,
      "international_designator": "2022-143A",
      "name": "CSS (MENGTIAN)",
      "omm": {
        "ARG_OF_PERICENTER": 284.6802,
        "BSTAR": 0.00025654553,
        "CLASSIFICATION_TYPE": "U",
        "ECCENTRICITY": 0.0004612,
        "ELEMENT_SET_NO": 999,
        "EPHEMERIS_TYPE": 0,
        "EPOCH": "2026-11-10T00:34:30.359136",
        "INCLINATION": 41.4671,
        "MEAN_ANOMALY": 75.3526,
        "MEAN_MOTION": 15.61635786,
        "MEAN_MOTION_DDOT": 0,
        "MEAN_MOTION_DOT": 0.00022456,
        "NORAD_CAT_ID": 54216,
        "OBJECT_ID": "2022-143A",
        "OBJECT_NAME": "CSS (MENGTIAN)",
        "RA_OF_ASC_NODE": 155.8173,
        "REV_AT_EPOCH": 30860
      },
      "perigee_altitude_km": 379.8,
      "period_minutes": 92.211,
      "semi_major_axis_km": 6761.1,
      "tle": {
        "line0": "CSS (MENGTIAN)",
        "line1": "1 54216U 22143A   26314.02396249  .00022456  00000+0  25655-3 0  9995",
        "line2": "2 54216  41.4671 155.8173 0004612 284.6802  75.3526 15.61635786308609"
      },
      "tle_unavailable_reason": null
    },
    {
      "apogee_altitude_km": 295,
      "catalog_number": 66515,
      "epoch": "2026-11-09T11:17:13.701408Z",
      "epoch_age_hours": 31.38,
      "international_designator": "2025-246C",
      "name": "SZ-21 MODULE",
      "omm": {
        "ARG_OF_PERICENTER": 345.2532,
        "BSTAR": 0.00038468936,
        "CLASSIFICATION_TYPE": "U",
        "ECCENTRICITY": 0.00130715,
        "ELEMENT_SET_NO": 999,
        "EPHEMERIS_TYPE": 0,
        "EPOCH": "2026-11-09T11:17:13.701408",
        "INCLINATION": 41.4657,
        "MEAN_ANOMALY": 14.7936,
        "MEAN_MOTION": 15.95717832,
        "MEAN_MOTION_DDOT": 0.000017304965,
        "MEAN_MOTION_DOT": 0.00161059,
        "NORAD_CAT_ID": 66515,
        "OBJECT_ID": "2025-246C",
        "OBJECT_NAME": "SZ-21 MODULE",
        "RA_OF_ASC_NODE": 112.1123,
        "REV_AT_EPOCH": 5678
      },
      "perigee_altitude_km": 277.6,
      "period_minutes": 90.242,
      "semi_major_axis_km": 6664.5,
      "tle": {
        "line0": "SZ-21 MODULE",
        "line1": "1 66515U 25246C   26313.47029747  .00161059  17305-4  38469-3 0  9992",
        "line2": "2 66515  41.4657 112.1123 0013071 345.2532  14.7936 15.95717832 56783"
      },
      "tle_unavailable_reason": null
    },
    {
      "apogee_altitude_km": 343,
      "catalog_number": 66906,
      "epoch": "2026-11-10T03:20:45.552768Z",
      "epoch_age_hours": 15.32,
      "international_designator": "1998-067XT",
      "name": "DUPLEX",
      "omm": {
        "ARG_OF_PERICENTER": 67.5256,
        "BSTAR": 0.00063596512,
        "CLASSIFICATION_TYPE": "U",
        "ECCENTRICITY": 0.00049025,
        "ELEMENT_SET_NO": 999,
        "EPHEMERIS_TYPE": 0,
        "EPOCH": "2026-11-10T03:20:45.552768",
        "INCLINATION": 51.6235,
        "MEAN_ANOMALY": 292.6263,
        "MEAN_MOTION": 15.76717813,
        "MEAN_MOTION_DDOT": 0,
        "MEAN_MOTION_DOT": 0.00104912,
        "NORAD_CAT_ID": 66906,
        "OBJECT_ID": "1998-067XT",
        "OBJECT_NAME": "DUPLEX",
        "RA_OF_ASC_NODE": 265.7919,
        "REV_AT_EPOCH": 5356
      },
      "perigee_altitude_km": 336.5,
      "period_minutes": 91.329,
      "semi_major_axis_km": 6717.9,
      "tle": {
        "line0": "DUPLEX",
        "line1": "1 66906U 98067XT  26314.13941612  .00104912  00000+0  63597-3 0  9999",
        "line2": "2 66906  51.6235 265.7919 0004902  67.5256 292.6263 15.76717813 53561"
      },
      "tle_unavailable_reason": null
    },
    {
      "apogee_altitude_km": 340.3,
      "catalog_number": 67683,
      "epoch": "2026-11-10T03:28:10.725312Z",
      "epoch_age_hours": 15.2,
      "international_designator": "1998-067YA",
      "name": "KNACKSAT-2",
      "omm": {
        "ARG_OF_PERICENTER": 64.3726,
        "BSTAR": 0.00083341905,
        "CLASSIFICATION_TYPE": "U",
        "ECCENTRICITY": 0.00092082,
        "ELEMENT_SET_NO": 999,
        "EPHEMERIS_TYPE": 0,
        "EPOCH": "2026-11-10T03:28:10.725312",
        "INCLINATION": 51.6238,
        "MEAN_ANOMALY": 295.8225,
        "MEAN_MOTION": 15.78708176,
        "MEAN_MOTION_DDOT": 0,
        "MEAN_MOTION_DOT": 0.00151644,
        "NORAD_CAT_ID": 67683,
        "OBJECT_ID": "1998-067YA",
        "OBJECT_NAME": "KNACKSAT-2",
        "RA_OF_ASC_NODE": 271.8581,
        "REV_AT_EPOCH": 4317
      },
      "perigee_altitude_km": 327.9,
      "period_minutes": 91.214,
      "semi_major_axis_km": 6712.2,
      "tle": {
        "line0": "KNACKSAT-2",
        "line1": "1 67683U 98067YA  26314.14456858  .00151644  00000+0  83342-3 0  9990",
        "line2": "2 67683  51.6238 271.8581 0009208  64.3726 295.8225 15.78708176 43174"
      },
      "tle_unavailable_reason": null
    },
    {
      "apogee_altitude_km": 313.1,
      "catalog_number": 67685,
      "epoch": "2026-11-10T05:33:03.407616Z",
      "epoch_age_hours": 13.12,
      "international_designator": "1998-067YC",
      "name": "GXIBA-1",
      "omm": {
        "ARG_OF_PERICENTER": 76.1482,
        "BSTAR": 0.00099008947,
        "CLASSIFICATION_TYPE": "U",
        "ECCENTRICITY": 0.00091054,
        "ELEMENT_SET_NO": 999,
        "EPHEMERIS_TYPE": 0,
        "EPOCH": "2026-11-10T05:33:03.407616",
        "INCLINATION": 51.6154,
        "MEAN_ANOMALY": 284.0535,
        "MEAN_MOTION": 15.88299702,
        "MEAN_MOTION_DDOT": 0,
        "MEAN_MOTION_DOT": 0.00288753,
        "NORAD_CAT_ID": 67685,
        "OBJECT_ID": "1998-067YC",
        "OBJECT_NAME": "GXIBA-1",
        "RA_OF_ASC_NODE": 266.334,
        "REV_AT_EPOCH": 4325
      },
      "perigee_altitude_km": 301,
      "period_minutes": 90.663,
      "semi_major_axis_km": 6685.2,
      "tle": {
        "line0": "GXIBA-1",
        "line1": "1 67685U 98067YC  26314.23128944  .00288753  00000+0  99009-3 0  9993",
        "line2": "2 67685  51.6154 266.3340 0009105  76.1482 284.0535 15.88299702 43255"
      },
      "tle_unavailable_reason": null
    },
    {
      "apogee_altitude_km": 210.5,
      "catalog_number": 67688,
      "epoch": "2026-11-09T21:45:55.550880Z",
      "epoch_age_hours": 20.9,
      "international_designator": "1998-067YF",
      "name": "HMU-SAT2",
      "omm": {
        "ARG_OF_PERICENTER": 159.658,
        "BSTAR": 0.0011994165,
        "CLASSIFICATION_TYPE": "U",
        "ECCENTRICITY": 0.00043445,
        "ELEMENT_SET_NO": 999,
        "EPHEMERIS_TYPE": 0,
        "EPOCH": "2026-11-09T21:45:55.550880",
        "INCLINATION": 51.6097,
        "MEAN_ANOMALY": 200.4614,
        "MEAN_MOTION": 16.24398043,
        "MEAN_MOTION_DDOT": 0.000011952655,
        "MEAN_MOTION_DOT": 0.03415772,
        "NORAD_CAT_ID": 67688,
        "OBJECT_ID": "1998-067YF",
        "OBJECT_NAME": "HMU-SAT2",
        "RA_OF_ASC_NODE": 260.3012,
        "REV_AT_EPOCH": 4322
      },
      "perigee_altitude_km": 204.8,
      "period_minutes": 88.648,
      "semi_major_axis_km": 6585.8,
      "tle": {
        "line0": "HMU-SAT2",
        "line1": "1 67688U 98067YF  26313.90689295  .03415772  11953-4  11994-2 0  9996",
        "line2": "2 67688  51.6097 260.3012 0004344 159.6580 200.4614 16.24398043 43226"
      },
      "tle_unavailable_reason": null
    },
    {
      "apogee_altitude_km": 423.8,
      "catalog_number": 68837,
      "epoch": "2026-11-10T04:12:02.822688Z",
      "epoch_age_hours": 14.47,
      "international_designator": "2026-093A",
      "name": "PROGRESS-MS 34",
      "omm": {
        "ARG_OF_PERICENTER": 8.9462,
        "BSTAR": 0.0001757453,
        "CLASSIFICATION_TYPE": "U",
        "ECCENTRICITY": 0.00072923,
        "ELEMENT_SET_NO": 999,
        "EPHEMERIS_TYPE": 0,
        "EPOCH": "2026-11-10T04:12:02.822688",
        "INCLINATION": 51.6322,
        "MEAN_ANOMALY": 351.1656,
        "MEAN_MOTION": 15.49289712,
        "MEAN_MOTION_DDOT": 0,
        "MEAN_MOTION_DOT": 0.00009346,
        "NORAD_CAT_ID": 68837,
        "OBJECT_ID": "2026-093A",
        "OBJECT_NAME": "PROGRESS-MS 34",
        "RA_OF_ASC_NODE": 297.6644,
        "REV_AT_EPOCH": 58773
      },
      "perigee_altitude_km": 413.8,
      "period_minutes": 92.946,
      "semi_major_axis_km": 6796.9,
      "tle": {
        "line0": "PROGRESS-MS 34",
        "line1": "1 68837U 26093A   26314.17503267  .00009346  00000+0  17575-3 0  9998",
        "line2": "2 68837  51.6322 297.6644 0007292   8.9462 351.1656 15.49289712587735"
      },
      "tle_unavailable_reason": null
    },
    {
      "apogee_altitude_km": 386,
      "catalog_number": 69049,
      "epoch": "2026-11-10T00:34:30.359136Z",
      "epoch_age_hours": 18.09,
      "international_designator": "2026-102A",
      "name": "TIANZHOU-10",
      "omm": {
        "ARG_OF_PERICENTER": 284.6802,
        "BSTAR": 0.00025654553,
        "CLASSIFICATION_TYPE": "U",
        "ECCENTRICITY": 0.0004612,
        "ELEMENT_SET_NO": 999,
        "EPHEMERIS_TYPE": 0,
        "EPOCH": "2026-11-10T00:34:30.359136",
        "INCLINATION": 41.4671,
        "MEAN_ANOMALY": 75.3526,
        "MEAN_MOTION": 15.61635786,
        "MEAN_MOTION_DDOT": 0,
        "MEAN_MOTION_DOT": 0.00022456,
        "NORAD_CAT_ID": 69049,
        "OBJECT_ID": "2026-102A",
        "OBJECT_NAME": "TIANZHOU-10",
        "RA_OF_ASC_NODE": 155.8173,
        "REV_AT_EPOCH": 31164
      },
      "perigee_altitude_km": 379.8,
      "period_minutes": 92.211,
      "semi_major_axis_km": 6761.1,
      "tle": {
        "line0": "TIANZHOU-10",
        "line1": "1 69049U 26102A   26314.02396249  .00022456  00000+0  25655-3 0  9994",
        "line2": "2 69049  41.4671 155.8173 0004612 284.6802  75.3526 15.61635786311647"
      },
      "tle_unavailable_reason": null
    },
    {
      "apogee_altitude_km": 386,
      "catalog_number": 69180,
      "epoch": "2026-11-10T00:34:30.359136Z",
      "epoch_age_hours": 18.09,
      "international_designator": "2026-113A",
      "name": "SHENZHOU-23 (SZ-23)",
      "omm": {
        "ARG_OF_PERICENTER": 284.6802,
        "BSTAR": 0.00025654553,
        "CLASSIFICATION_TYPE": "U",
        "ECCENTRICITY": 0.0004612,
        "ELEMENT_SET_NO": 999,
        "EPHEMERIS_TYPE": 0,
        "EPOCH": "2026-11-10T00:34:30.359136",
        "INCLINATION": 41.4671,
        "MEAN_ANOMALY": 75.3526,
        "MEAN_MOTION": 15.61635786,
        "MEAN_MOTION_DDOT": 0,
        "MEAN_MOTION_DOT": 0.00022456,
        "NORAD_CAT_ID": 69180,
        "OBJECT_ID": "2026-113A",
        "OBJECT_NAME": "SHENZHOU-23 (SZ-23)",
        "RA_OF_ASC_NODE": 155.8173,
        "REV_AT_EPOCH": 30842
      },
      "perigee_altitude_km": 379.8,
      "period_minutes": 92.211,
      "semi_major_axis_km": 6761.1,
      "tle": {
        "line0": "SHENZHOU-23 (SZ-23)",
        "line1": "1 69180U 26113A   26314.02396249  .00022456  00000+0  25655-3 0  9992",
        "line2": "2 69180  41.4671 155.8173 0004612 284.6802  75.3526 15.61635786308425"
      },
      "tle_unavailable_reason": null
    },
    {
      "apogee_altitude_km": 423.8,
      "catalog_number": 100057,
      "epoch": "2026-11-10T04:12:02.822688Z",
      "epoch_age_hours": 14.47,
      "international_designator": "2026-162A",
      "name": "SOYUZ-MS 29",
      "omm": {
        "ARG_OF_PERICENTER": 8.9462,
        "BSTAR": 0.0001757453,
        "CLASSIFICATION_TYPE": "U",
        "ECCENTRICITY": 0.00072923,
        "ELEMENT_SET_NO": 999,
        "EPHEMERIS_TYPE": 0,
        "EPOCH": "2026-11-10T04:12:02.822688",
        "INCLINATION": 51.6322,
        "MEAN_ANOMALY": 351.1656,
        "MEAN_MOTION": 15.49289712,
        "MEAN_MOTION_DDOT": 0,
        "MEAN_MOTION_DOT": 0.00009346,
        "NORAD_CAT_ID": 100057,
        "OBJECT_ID": "2026-162A",
        "OBJECT_NAME": "SOYUZ-MS 29",
        "RA_OF_ASC_NODE": 297.6644,
        "REV_AT_EPOCH": 59446
      },
      "perigee_altitude_km": 413.8,
      "period_minutes": 92.946,
      "semi_major_axis_km": 6796.9,
      "tle": null,
      "tle_unavailable_reason": "catalog_number_above_99999"
    },
    {
      "apogee_altitude_km": 423.8,
      "catalog_number": 100712,
      "epoch": "2026-11-10T04:12:02.822688Z",
      "epoch_age_hours": 14.47,
      "international_designator": "2026-212A",
      "name": "PROGRESS-MS 35",
      "omm": {
        "ARG_OF_PERICENTER": 8.9462,
        "BSTAR": 0.0001757453,
        "CLASSIFICATION_TYPE": "U",
        "ECCENTRICITY": 0.00072923,
        "ELEMENT_SET_NO": 999,
        "EPHEMERIS_TYPE": 0,
        "EPOCH": "2026-11-10T04:12:02.822688",
        "INCLINATION": 51.6322,
        "MEAN_ANOMALY": 351.1656,
        "MEAN_MOTION": 15.49289712,
        "MEAN_MOTION_DDOT": 0,
        "MEAN_MOTION_DOT": 0.00009346,
        "NORAD_CAT_ID": 100712,
        "OBJECT_ID": "2026-212A",
        "OBJECT_NAME": "PROGRESS-MS 35",
        "RA_OF_ASC_NODE": 297.6644,
        "REV_AT_EPOCH": 855
      },
      "perigee_altitude_km": 413.8,
      "period_minutes": 92.946,
      "semi_major_axis_km": 6796.9,
      "tle": null,
      "tle_unavailable_reason": "catalog_number_above_99999"
    },
    {
      "apogee_altitude_km": 423.8,
      "catalog_number": 100882,
      "epoch": "2026-11-10T04:12:02.822688Z",
      "epoch_age_hours": 14.47,
      "international_designator": "2026-226A",
      "name": "CREW DRAGON 13",
      "omm": {
        "ARG_OF_PERICENTER": 8.9462,
        "BSTAR": 0.0001757453,
        "CLASSIFICATION_TYPE": "U",
        "ECCENTRICITY": 0.00072923,
        "ELEMENT_SET_NO": 999,
        "EPHEMERIS_TYPE": 0,
        "EPOCH": "2026-11-10T04:12:02.822688",
        "INCLINATION": 51.6322,
        "MEAN_ANOMALY": 351.1656,
        "MEAN_MOTION": 15.49289712,
        "MEAN_MOTION_DDOT": 0,
        "MEAN_MOTION_DOT": 0.00009346,
        "NORAD_CAT_ID": 100882,
        "OBJECT_ID": "2026-226A",
        "OBJECT_NAME": "CREW DRAGON 13",
        "RA_OF_ASC_NODE": 297.6644,
        "REV_AT_EPOCH": 637
      },
      "perigee_altitude_km": 413.8,
      "period_minutes": 92.946,
      "semi_major_axis_km": 6796.9,
      "tle": null,
      "tle_unavailable_reason": "catalog_number_above_99999"
    },
    {
      "apogee_altitude_km": 423.8,
      "catalog_number": 101031,
      "epoch": "2026-11-10T04:12:02.822688Z",
      "epoch_age_hours": 14.47,
      "international_designator": "2026-233A",
      "name": "DRAGON CRS-35",
      "omm": {
        "ARG_OF_PERICENTER": 8.9462,
        "BSTAR": 0.0001757453,
        "CLASSIFICATION_TYPE": "U",
        "ECCENTRICITY": 0.00072923,
        "ELEMENT_SET_NO": 999,
        "EPHEMERIS_TYPE": 0,
        "EPOCH": "2026-11-10T04:12:02.822688",
        "INCLINATION": 51.6322,
        "MEAN_ANOMALY": 351.1656,
        "MEAN_MOTION": 15.49289712,
        "MEAN_MOTION_DDOT": 0,
        "MEAN_MOTION_DOT": 0.00009346,
        "NORAD_CAT_ID": 101031,
        "OBJECT_ID": "2026-233A",
        "OBJECT_NAME": "DRAGON CRS-35",
        "RA_OF_ASC_NODE": 297.6644,
        "REV_AT_EPOCH": 449
      },
      "perigee_altitude_km": 413.8,
      "period_minutes": 92.946,
      "semi_major_axis_km": 6796.9,
      "tle": null,
      "tle_unavailable_reason": "catalog_number_above_99999"
    }
  ],
  "observed_at_ms": 1794336000000,
  "query": {
    "group": "stations"
  },
  "returned": 19,
  "source_url": "https://celestrak.org/NORAD/elements/gp.php?GROUP=stations&FORMAT=JSON",
  "total": 19,
  "truncated": false
}
```

### Gp search

- Capability: `satellites/gp_search`
- Description: Search current GP element sets by object name (substring, case-insensitive, at least 3 characters) or by international designator: a launch (YYYY-NNN returns every tracked object from it) or one object (YYYY-NNNA). Returns up to limit element sets with OMM keywords, TLE lines where available and derived orbit size. Source: CelesTrak gp.php?NAME= or ?INTDES= (JSON, plus TLE). An empty element_sets list means CelesTrak tracks nothing matching. Data refreshes about every 2 hours (CelesTrak usage policy: download once per update); epoch_age_hours shows freshness. Objects cataloged since 2026-07-11 have 6-digit catalog numbers and no TLE, only OMM.
- Instructions: Find a satellite, rocket body or crewed vehicle by name (STARSHIP, ZARYA, HUBBLE) or every object from one launch once it is cataloged, e.g. a new SpaceX launch by its designator.
- Cost: 5 credits per call
- Capability file: [Gp search](https://alexandria.firecrawl.dev/agents/providers/celestrak-org/satellites/gp_search)

Accepted options:
- `international_designator` (string): Launch designator YYYY-NNN (all objects from that launch) or object designator YYYY-NNNA. Pattern: ^\s*[0-9]{4}-[0-9]{3}[A-Za-z]{0,3}\s*$. Example: `<international_designator>`
- `limit` (number): Most element sets to return (default 100). Example: `100`
- `name` (string): Part of the object name, e.g. ZARYA or COSMOS 2251 DEB. Exactly one of name or international_designator. Example: `<name>`

Response schema example:
```json
{
  "element_sets": [
    {
      "apogee_altitude_km": 423.8,
      "catalog_number": 25544,
      "epoch": "2026-11-10T04:12:02.822688Z",
      "epoch_age_hours": 14.47,
      "international_designator": "1998-067A",
      "name": "ISS (ZARYA)",
      "omm": {
        "ARG_OF_PERICENTER": 8.9462,
        "BSTAR": 0.0001757453,
        "CLASSIFICATION_TYPE": "U",
        "ECCENTRICITY": 0.00072923,
        "ELEMENT_SET_NO": 999,
        "EPHEMERIS_TYPE": 0,
        "EPOCH": "2026-11-10T04:12:02.822688",
        "INCLINATION": 51.6322,
        "MEAN_ANOMALY": 351.1656,
        "MEAN_MOTION": 15.49289712,
        "MEAN_MOTION_DDOT": 0,
        "MEAN_MOTION_DOT": 0.00009346,
        "NORAD_CAT_ID": 25544,
        "OBJECT_ID": "1998-067A",
        "OBJECT_NAME": "ISS (ZARYA)",
        "RA_OF_ASC_NODE": 297.6644,
        "REV_AT_EPOCH": 59438
      },
      "perigee_altitude_km": 413.8,
      "period_minutes": 92.946,
      "semi_major_axis_km": 6796.9,
      "tle": {
        "line0": "ISS (ZARYA)",
        "line1": "1 25544U 98067A   26314.17503267  .00009346  00000+0  17575-3 0  9996",
        "line2": "2 25544  51.6322 297.6644 0007292   8.9462 351.1656 15.49289712594382"
      },
      "tle_unavailable_reason": null
    }
  ],
  "observed_at_ms": 1794336000000,
  "query": {
    "name": "ZARYA"
  },
  "returned": 1,
  "source_url": "https://celestrak.org/NORAD/elements/gp.php?NAME=ZARYA&FORMAT=JSON",
  "total": 1,
  "truncated": false
}
```
