{
  "openapi": "3.0.1",
  "info": {
    "title": "FAA Aircraft Registry (N-Number) Scraper",
    "description": "Supercharge your aircraft research! Automate collection of detailed aircraft data with advanced filtering capabilities. Get complete aircraft information, ownership details, technical specifications, and registration data from the official FAA Aircraft Registry.",
    "version": "1.3",
    "x-build-id": "aRAJCY8dc8ELEapOl"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/parseforge~faa-aircraft-registry-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-parseforge-faa-aircraft-registry-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~faa-aircraft-registry-scraper/runs": {
      "post": {
        "operationId": "runs-sync-parseforge-faa-aircraft-registry-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~faa-aircraft-registry-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-parseforge-faa-aircraft-registry-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": {
          "nNumber": {
            "title": "N-Number",
            "type": "string",
            "description": "Enter a specific aircraft N-Number to search for (e.g., 'N12345'). Leave empty to search by other criteria."
          },
          "aircraftMake": {
            "title": "Aircraft Make",
            "type": "string",
            "description": "Enter aircraft manufacturer (e.g., 'Cessna', 'Boeing', 'Airbus'). Leave empty to include all makes."
          },
          "aircraftModel": {
            "title": "Aircraft Model",
            "type": "string",
            "description": "Enter aircraft model (e.g., '172', '737', 'A320'). Leave empty to include all models."
          },
          "ownerName": {
            "title": "Owner Name",
            "type": "string",
            "description": "Enter owner name or company name to search for. Leave empty to include all owners."
          },
          "serialNumber": {
            "title": "Serial Number",
            "type": "string",
            "description": "Enter aircraft serial number to search for. Leave empty to include all serial numbers."
          },
          "aircraftCategory": {
            "title": "Aircraft Category",
            "type": "array",
            "description": "Select aircraft categories to filter by (optional). Leave empty to include all categories.",
            "items": {
              "type": "string",
              "enum": [
                "AIRPLANE",
                "ROTORCRAFT",
                "GLIDER",
                "BALLOON",
                "AIRSHIP",
                "WEIGHT_SHIFT_CONTROL",
                "POWERED_PARACHUTE",
                "GYROPLANE"
              ]
            }
          },
          "aircraftClass": {
            "title": "Aircraft Class",
            "type": "array",
            "description": "Select aircraft classes to filter by (optional). Leave empty to include all classes.",
            "items": {
              "type": "string",
              "enum": [
                "SINGLE_ENGINE_LAND",
                "MULTI_ENGINE_LAND",
                "SINGLE_ENGINE_SEA",
                "MULTI_ENGINE_SEA",
                "ROTORCRAFT_HELICOPTER",
                "ROTORCRAFT_GYROPLANE",
                "GLIDER",
                "BALLOON",
                "AIRSHIP",
                "WEIGHT_SHIFT_CONTROL",
                "POWERED_PARACHUTE"
              ]
            }
          },
          "registrationStatus": {
            "title": "Registration Status",
            "type": "array",
            "description": "Select registration status to filter by (optional). Leave empty to include all statuses.",
            "items": {
              "type": "string",
              "enum": [
                "ACTIVE",
                "EXPIRED",
                "CANCELLED",
                "PENDING",
                "SUSPENDED"
              ]
            }
          },
          "state": {
            "title": "State/Country",
            "type": "string",
            "description": "Enter state abbreviation (e.g., 'CA', 'TX') or country to filter by. Leave empty to include all locations."
          },
          "county": {
            "title": "County",
            "type": "string",
            "description": "Enter county name to filter by (e.g., 'CITRUS', 'ORANGE'). Leave empty to include all counties."
          },
          "yearFrom": {
            "title": "Year From",
            "minimum": 1900,
            "maximum": 2030,
            "type": "integer",
            "description": "Minimum year of manufacture (optional). Leave empty for no minimum year."
          },
          "yearTo": {
            "title": "Year To",
            "minimum": 1900,
            "maximum": 2030,
            "type": "integer",
            "description": "Maximum year of manufacture (optional). Leave empty for no maximum year."
          },
          "maxItems": {
            "title": "Max Items",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "Maximum number of aircraft to collect (optional). Leave empty for unlimited (paid users only). Free users must specify this parameter and are limited to 100 items."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}