{ "openapi": "3.0.1", "info": { "title": "FAA Aircraft Registry Scraper", "description": "Scrape the FAA Aircraft Registry: N-Number, owner name and address, make, model, serial number, year, engine, airworthiness and registration status. Search by N-Number, make/model, owner, state, county or year.", "version": "0.0", "x-build-id": "bumNGr2a6HsaUkxbQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/gio21~faa-aircraft-registry-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-gio21-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/gio21~faa-aircraft-registry-scraper/runs": { "post": { "operationId": "runs-sync-gio21-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/gio21~faa-aircraft-registry-scraper/run-sync": { "post": { "operationId": "run-sync-gio21-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": { "nNumbers": { "title": "N-Numbers", "type": "array", "description": "Specific aircraft tail numbers to look up (e.g. \"N172SP\"). When provided, each aircraft is fetched live from the FAA inquiry page (freshest data). Leave empty to search the registry database by the filters below.", "items": { "type": "string" } }, "aircraftMake": { "title": "Aircraft make", "type": "string", "description": "Manufacturer name, partial match (e.g. \"Cessna\", \"Boeing\", \"Piper\")." }, "aircraftModel": { "title": "Aircraft model", "type": "string", "description": "Model, partial match (e.g. \"172\", \"737\", \"PA-28\")." }, "ownerName": { "title": "Owner name", "type": "string", "description": "Registered owner or company name, partial match (e.g. \"Delta Air Lines\")." }, "serialNumber": { "title": "Serial number", "type": "string", "description": "Aircraft serial number, partial match." }, "state": { "title": "State", "type": "string", "description": "Registered owner's US state, 2-letter code (e.g. \"FL\", \"TX\")." }, "county": { "title": "County code", "type": "string", "description": "Registered owner's 3-digit FIPS county code (e.g. \"017\" for Citrus County, FL). The FAA database stores county codes, not names. Best combined with a state." }, "yearFrom": { "title": "Year of manufacture from", "minimum": 1900, "type": "integer", "description": "Minimum year of manufacture." }, "yearTo": { "title": "Year of manufacture to", "minimum": 1900, "type": "integer", "description": "Maximum year of manufacture." }, "registrationStatus": { "title": "Registration status", "enum": [ "any", "valid", "other" ], "type": "string", "description": "Filter by registration status.", "default": "any" }, "maxItems": { "title": "Max items", "minimum": 0, "type": "integer", "description": "Maximum number of aircraft to return. Set 0 for no limit (the full registry has ~290,000 aircraft).", "default": 100 } } }, "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 } } } } } } } } } }