{
  "openapi": "3.0.1",
  "info": {
    "title": "CelesTrak Satellites Orbital Catalog Scraper",
    "description": "Pull fresh CelesTrak orbital element sets for 30,000+ tracked Earth-orbiting objects. Filter by group (active satellites, Starlink, GPS, Galileo, ISS, debris, weather, etc.), search by NORAD ID or name. Returns inclination, eccentricity, mean motion, epoch, and full orbital parameters per object.",
    "version": "0.0",
    "x-build-id": "3SB3x0NgQnMwMIup3"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/parseforge~celestrak-tle-satellites-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-parseforge-celestrak-tle-satellites-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/parseforge~celestrak-tle-satellites-scraper/runs": {
      "post": {
        "operationId": "runs-sync-parseforge-celestrak-tle-satellites-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/parseforge~celestrak-tle-satellites-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-parseforge-celestrak-tle-satellites-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "group": {
            "title": "Satellite Group",
            "enum": [
              "active",
              "stations",
              "visual",
              "analyst",
              "weather",
              "noaa",
              "goes",
              "resource",
              "sarsat",
              "dmc",
              "tdrss",
              "argos",
              "planet",
              "spire",
              "geo",
              "intelsat",
              "ses",
              "eutelsat",
              "iridium",
              "iridium-NEXT",
              "starlink",
              "oneweb",
              "kuiper",
              "qianfan",
              "hulianwang",
              "orbcomm",
              "globalstar",
              "swarm",
              "amateur",
              "x-comm",
              "other-comm",
              "satnogs",
              "gnss",
              "gps-ops",
              "glo-ops",
              "galileo",
              "beidou",
              "sbas",
              "nnss",
              "musson",
              "science",
              "geodetic",
              "engineering",
              "education",
              "military",
              "radar",
              "cubesat",
              "other",
              "last-30-days",
              "cosmos-2251-debris",
              "iridium-33-debris",
              "fengyun-1c-debris"
            ],
            "type": "string",
            "description": "Pre-defined satellite group to retrieve. 'active' returns every active object. Specialized groups narrow to constellations, missions, or debris fields. Mutually exclusive with NORAD ID and International Designator (those take precedence).",
            "default": "active"
          },
          "fetchAllGroups": {
            "title": "Fetch All Groups",
            "type": "boolean",
            "description": "Iterate every available satellite group sequentially and merge results into one dataset. Overrides the single-group selection above. Useful for a complete catalogue snapshot in a single run.",
            "default": false
          },
          "supcat": {
            "title": "Supplementary Catalogue (SUPCAT)",
            "type": "string",
            "description": "Optional supplementary catalogue identifier (e.g. specific operator or mission catalog) supported by the upstream catalogue.",
            "default": ""
          },
          "search": {
            "title": "Name Search",
            "type": "string",
            "description": "Filter results by object name (case-insensitive substring, e.g. 'STARLINK', 'ISS', 'NOAA'). Filter is applied after fetching the chosen group.",
            "default": ""
          },
          "noradId": {
            "title": "NORAD Catalog ID",
            "minimum": 1,
            "type": "integer",
            "description": "Return only the object with this NORAD catalog ID (e.g. 25544 = ISS). Takes precedence over Group and International Designator."
          },
          "objectId": {
            "title": "International Designator",
            "type": "string",
            "description": "Return only the object with this COSPAR international designator (e.g. '1998-067A' = ISS). Takes precedence over Group when set, but yields to NORAD Catalog ID if both are provided.",
            "default": ""
          },
          "minInclination": {
            "title": "Minimum Inclination (degrees)",
            "minimum": 0,
            "maximum": 180,
            "type": "number",
            "description": "Only include objects with orbital inclination greater than or equal to this value."
          },
          "maxInclination": {
            "title": "Maximum Inclination (degrees)",
            "minimum": 0,
            "maximum": 180,
            "type": "number",
            "description": "Only include objects with orbital inclination less than or equal to this value."
          },
          "maxItems": {
            "title": "Max Items",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000"
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}