{
  "openapi": "3.0.1",
  "info": {
    "title": "ADS-B Flight Tracker API: Live Aircraft Data",
    "description": "Live aircraft positions worldwide from FlyItalyADSB's own ADS-B and MLAT receiver network: search by area, ICAO hex, callsign or registration, or get all military aircraft. Plus daily flight tracks since 2022, overflights and emergencies. Export JSON, CSV or Excel, schedule runs or call it via API.",
    "version": "1.0",
    "x-build-id": "WbxZPdZy2xvejhrfl"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/flyitalyadsb~adsb-flight-tracker/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-flyitalyadsb-adsb-flight-tracker",
        "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/flyitalyadsb~adsb-flight-tracker/runs": {
      "post": {
        "operationId": "runs-sync-flyitalyadsb-adsb-flight-tracker",
        "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/flyitalyadsb~adsb-flight-tracker/run-sync": {
      "post": {
        "operationId": "run-sync-flyitalyadsb-adsb-flight-tracker",
        "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",
        "required": [
          "mode"
        ],
        "properties": {
          "mode": {
            "title": "What to get",
            "enum": [
              "area",
              "aircraft",
              "military",
              "pia",
              "ladd",
              "history",
              "profile",
              "overflights",
              "events",
              "flights"
            ],
            "type": "string",
            "description": "Live data: aircraft in an area, specific aircraft, or military / PIA / LADD aircraft worldwide. History: an aircraft's daily track, its profile, the aircraft that flew over a place, notable traffic (emergencies, military, interesting aircraft) in an area, or observed flights (a callsign's routes, an aircraft's flight log, an airport's departures and arrivals).",
            "default": "area"
          },
          "latitude": {
            "title": "Latitude",
            "minimum": -90,
            "maximum": 90,
            "type": "number",
            "description": "Centre of the area, in decimal degrees (-90 to 90). For the area, overflights and notable-traffic modes."
          },
          "longitude": {
            "title": "Longitude",
            "minimum": -180,
            "maximum": 180,
            "type": "number",
            "description": "Centre of the area, in decimal degrees (-180 to 180)."
          },
          "radiusKm": {
            "title": "Radius",
            "minimum": 0.1,
            "maximum": 20040,
            "type": "number",
            "description": "Up to 20,040 km (the whole world) for live aircraft and notable traffic; up to 50 km for overflights.",
            "default": 50
          },
          "icao": {
            "title": "ICAO hex addresses",
            "type": "array",
            "description": "24-bit transponder addresses, 6 hex characters (e.g. 4ca7b4). For specific aircraft, daily tracks, profiles and observed flights. Up to 1,000.",
            "items": {
              "type": "string"
            }
          },
          "callsigns": {
            "title": "Callsigns",
            "type": "array",
            "description": "Callsigns as transmitted (e.g. RYR4TJ); a flight number such as FR5518 is tried too. For specific aircraft and observed flights.",
            "items": {
              "type": "string"
            }
          },
          "registrations": {
            "title": "Registrations",
            "type": "array",
            "description": "Tail numbers (e.g. EI-DCL), dashes optional. For specific aircraft and observed flights.",
            "items": {
              "type": "string"
            }
          },
          "dates": {
            "title": "Days (UTC)",
            "type": "array",
            "description": "YYYY-MM-DD, UTC days. Daily track: since 2022; empty = the most recent day with a track. Observed flights at an airport: one lookup per day; empty = the latest day available (yesterday).",
            "items": {
              "type": "string"
            }
          },
          "from": {
            "title": "From",
            "type": "string",
            "description": "Overflights: ISO 8601 (e.g. 2026-10-25T08:00:00Z; no zone = UTC) or Unix seconds; empty = one hour before \"to\"; the window can be at most 24 hours. Observed flights of an aircraft: the first UTC day (YYYY-MM-DD); empty = the last 7 days; at most 31 days."
          },
          "to": {
            "title": "To",
            "type": "string",
            "description": "Overflights: ISO 8601 or Unix seconds; empty = now. Observed flights of an aircraft: the last UTC day, included."
          },
          "sinceHours": {
            "title": "Notable traffic in the last",
            "minimum": 1,
            "maximum": 168,
            "type": "integer",
            "description": "Up to 168 hours (7 days).",
            "default": 24
          },
          "eventKinds": {
            "title": "Kinds of notable traffic",
            "type": "array",
            "description": "Empty: all three.",
            "items": {
              "type": "string",
              "enum": [
                "emergency",
                "military",
                "interesting"
              ],
              "enumTitles": [
                "Emergencies (squawk 7500/7600/7700)",
                "Military aircraft",
                "Interesting aircraft"
              ]
            }
          },
          "airports": {
            "title": "Airports",
            "type": "array",
            "description": "ICAO (e.g. EGLL) or IATA (e.g. LHR) codes: the departures and/or arrivals the network observed there on the days in \"Days (UTC)\".",
            "items": {
              "type": "string"
            }
          },
          "flightDays": {
            "title": "Days back for callsigns",
            "minimum": 1,
            "maximum": 14,
            "type": "integer",
            "description": "How many days back a callsign's flights go, up to yesterday.",
            "default": 7
          },
          "airportFlights": {
            "title": "At airports",
            "enum": [
              "both",
              "departures",
              "arrivals"
            ],
            "type": "string",
            "description": "Departures, arrivals or both.",
            "default": "both"
          },
          "includeOnGround": {
            "title": "Include aircraft on the ground",
            "type": "boolean",
            "description": "Live modes.",
            "default": true
          },
          "minAltitudeFt": {
            "title": "Minimum altitude",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "Live modes: barometric altitude; aircraft without one are left out when set."
          },
          "maxAltitudeFt": {
            "title": "Maximum altitude",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "Live modes and overflights."
          },
          "maxItems": {
            "title": "Maximum results",
            "minimum": 1,
            "type": "integer",
            "description": "Stop after this many rows. Empty: no limit beyond the run's spending limit."
          },
          "apiKey": {
            "title": "Your flyitalyadsb API key",
            "type": "string",
            "description": "Optional. With your own key (free at https://flyitalyadsb.com/en/data/api/) results are not charged here and your plan's limits apply (radius, requests per minute, per month). Without it, results are charged per item."
          }
        }
      },
      "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}