{ "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": "2.8", "x-build-id": "eIsQcL3rl3uVTTChU" }, "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": { "maxItems": { "title": "🌐 Global Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Global maximum number of records to collect across ALL datasets. This setting has priority over individual dataset maxItems settings. Leave empty for unlimited (paid users only). Free users must specify this parameter and are limited to 100 items." }, "datasets": { "title": "📊 Datasets to Return", "type": "array", "description": "Select which datasets to collect and return. You can choose multiple datasets or leave empty to return all datasets.", "items": { "type": "string", "enum": [ "master", "acftref", "engine", "dealer", "dereg", "docindex", "reserved" ], "enumTitles": [ "✈️ Master Aircraft Registry", "📋 Aircraft Reference", "🔧 Engine Reference", "🏪 Aircraft Dealer", "❌ Deregistered Aircraft", "📄 Document Index", "🔒 Reserved N-Numbers" ] } }, "master_maxItems": { "title": "Max Items for Master Dataset", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of master aircraft registry records to collect (optional). Leave empty for unlimited (paid users only). Free users must specify this parameter and are limited to 100 items." }, "master_N-NUMBER": { "title": "N-Number", "type": "string", "description": "Enter a specific aircraft N-Number to search for (e.g., 'N12345' or '12345'). The 'N' prefix is optional. Note: Only currently registered aircraft are in MASTER. For deregistered aircraft, use the DEREG dataset filter." }, "master_SERIAL NUMBER": { "title": "Serial Number", "type": "string", "description": "Enter aircraft serial number to search for. Leave empty to include all serial numbers." }, "master_MFR MDL CODE": { "title": "Manufacturer Model Code", "type": "string", "description": "Enter manufacturer model code. Leave empty to include all codes." }, "master_ENG MFR MDL": { "title": "Engine Manufacturer Model", "type": "string", "description": "Enter engine manufacturer model. Leave empty to include all engines." }, "master_YEAR MFR FROM": { "title": "Year Manufactured From", "minimum": 1900, "maximum": 2030, "type": "integer", "description": "Minimum year of manufacture" }, "master_YEAR MFR TO": { "title": "Year Manufactured To", "minimum": 1900, "maximum": 2030, "type": "integer", "description": "Maximum year of manufacture" }, "master_TYPE REGISTRANT": { "title": "Type Registrant", "type": "array", "description": "Select registrant types to filter by", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9" ], "enumTitles": [ "Individual", "Partnership", "Corporation", "Co-Ownership", "Government", "Non-Profit", "Other", "Unknown", "Not Specified" ] } }, "master_NAME": { "title": "Owner Name", "type": "string", "description": "Enter owner name or company name to search for. Leave empty to include all owners." }, "master_STREET": { "title": "Street Address", "type": "string", "description": "Enter street address to search for. Leave empty to include all addresses." }, "master_CITY": { "title": "City", "type": "string", "description": "Enter city name to search for. Leave empty to include all cities." }, "master_STATE": { "title": "State", "type": "string", "description": "Enter state abbreviation (e.g., 'CA', 'TX', 'FL'). Leave empty to include all states." }, "master_ZIP CODE": { "title": "ZIP Code", "type": "string", "description": "Enter ZIP code to search for. Leave empty to include all ZIP codes." }, "master_REGION": { "title": "Region", "type": "array", "description": "Select regions to filter by", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "A", "B", "C", "D", "E", "F", "G", "H", "I", "J", "K", "L", "M", "N", "O", "P", "Q", "R", "S", "T", "U", "V", "W", "X", "Y", "Z" ], "enumTitles": [ "Region 1", "Region 2", "Region 3", "Region 4", "Region 5", "Region 6", "Region 7", "Region 8", "Region 9", "Region A", "Region B", "Region C", "Region D", "Region E", "Region F", "Region G", "Region H", "Region I", "Region J", "Region K", "Region L", "Region M", "Region N", "Region O", "Region P", "Region Q", "Region R", "Region S", "Region T", "Region U", "Region V", "Region W", "Region X", "Region Y", "Region Z" ] } }, "master_COUNTY": { "title": "County", "type": "string", "description": "Enter county name to search for. Leave empty to include all counties." }, "master_COUNTRY": { "title": "Country", "type": "string", "description": "Enter country code (e.g., 'US', 'CA'). Leave empty to include all countries." }, "master_TYPE AIRCRAFT": { "title": "Type Aircraft", "type": "array", "description": "Select aircraft types to filter by", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9" ], "enumTitles": [ "Airplane", "Rotorcraft", "Glider", "Balloon", "Airship", "Weight Shift Control", "Powered Parachute", "Gyroplane", "Other" ] } }, "master_TYPE ENGINE": { "title": "Type Engine", "type": "array", "description": "Select engine types to filter by", "items": { "type": "string", "enum": [ "0", "1", "2", "3", "4", "5", "6", "7", "8", "9" ], "enumTitles": [ "None", "Reciprocating", "Turbojet", "Turboprop", "Turboshaft", "Turbofan", "Ramjet", "Pulsejet", "Rocket", "Other" ] } }, "master_STATUS CODE": { "title": "Status Code", "type": "array", "description": "Select status codes to filter by", "items": { "type": "string", "enum": [ "A", "C", "D", "E", "F", "G", "H", "I", "J", "K", "L", "M", "N", "O", "P", "Q", "R", "S", "T", "U", "V", "W", "X", "Y", "Z" ], "enumTitles": [ "Active", "Cancelled", "Deregistered", "Expired", "Forfeited", "Government", "Historical", "Inactive", "Invalid", "Kit", "Limited", "Manufacturer", "Non-Active", "Other", "Pending", "Qualified", "Reserved", "Special", "Temporary", "Unregistered", "Valid", "Withdrawn", "Experimental", "Yearly", "Zero" ] } }, "master_MODE S CODE": { "title": "Mode S Code", "type": "string", "description": "Enter Mode S code to search for. Leave empty to include all codes." }, "master_FRACT OWNER": { "title": "Fractional Owner", "type": "string", "description": "Enter fractional owner information. Leave empty to include all." }, "master_KIT MFR": { "title": "Kit Manufacturer", "type": "string", "description": "Enter kit manufacturer name. Leave empty to include all." }, "master_KIT MODEL": { "title": "Kit Model", "type": "string", "description": "Enter kit model name. Leave empty to include all." }, "acftref_maxItems": { "title": "Max Items for Aircraft Reference Dataset", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of aircraft reference records to collect (optional). Leave empty for unlimited (paid users only). Free users must specify this parameter and are limited to 100 items." }, "acftref_CODE": { "title": "Code", "type": "string", "description": "Enter aircraft code to search for. Leave empty to include all codes." }, "acftref_MFR": { "title": "Manufacturer", "type": "string", "description": "Enter aircraft manufacturer name (e.g., 'Cessna', 'Boeing', 'Airbus'). Leave empty to include all manufacturers." }, "acftref_MODEL": { "title": "Model", "type": "string", "description": "Enter aircraft model (e.g., '172', '737', 'A320'). Leave empty to include all models." }, "acftref_TYPE-ACFT": { "title": "Type Aircraft", "type": "array", "description": "Select aircraft types to filter by", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9" ], "enumTitles": [ "Airplane", "Rotorcraft", "Glider", "Balloon", "Airship", "Weight Shift Control", "Powered Parachute", "Gyroplane", "Other" ] } }, "acftref_TYPE-ENG": { "title": "Type Engine", "type": "array", "description": "Select engine types to filter by", "items": { "type": "string", "enum": [ "0", "1", "2", "3", "4", "5", "6", "7", "8", "9" ], "enumTitles": [ "None", "Reciprocating", "Turbojet", "Turboprop", "Turboshaft", "Turbofan", "Ramjet", "Pulsejet", "Rocket", "Other" ] } }, "acftref_AC-CAT": { "title": "Aircraft Category", "type": "array", "description": "Select aircraft categories to filter by", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9" ], "enumTitles": [ "Standard", "Utility", "Acrobatic", "Transport", "Commuter", "Normal", "Restricted", "Limited", "Other" ] } }, "acftref_NO-ENG FROM": { "title": "Min Number of Engines", "minimum": 0, "maximum": 10, "type": "integer", "description": "Minimum number of engines" }, "acftref_NO-ENG TO": { "title": "Max Number of Engines", "minimum": 0, "maximum": 10, "type": "integer", "description": "Maximum number of engines" }, "acftref_NO-SEATS FROM": { "title": "Min Number of Seats", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Minimum number of seats" }, "acftref_NO-SEATS TO": { "title": "Max Number of Seats", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of seats" }, "engine_maxItems": { "title": "Max Items for Engine Dataset", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of engine records to collect (optional). Leave empty for unlimited (paid users only). Free users must specify this parameter and are limited to 100 items." }, "engine_CODE": { "title": "Code", "type": "string", "description": "Enter engine code to search for. Leave empty to include all codes." }, "engine_MFR": { "title": "Manufacturer", "type": "string", "description": "Enter engine manufacturer name (e.g., 'Lycoming', 'Pratt & Whitney', 'Rolls-Royce'). Leave empty to include all manufacturers." }, "engine_MODEL": { "title": "Model", "type": "string", "description": "Enter engine model. Leave empty to include all models." }, "engine_TYPE": { "title": "Type", "type": "array", "description": "Select engine types to filter by", "items": { "type": "string", "enum": [ "0", "1", "2", "3", "4", "5", "6", "7", "8", "9" ], "enumTitles": [ "None", "Reciprocating", "Turbojet", "Turboprop", "Turboshaft", "Turbofan", "Ramjet", "Pulsejet", "Rocket", "Other" ] } }, "engine_HORSEPOWER FROM": { "title": "Min Horsepower", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Minimum horsepower" }, "engine_HORSEPOWER TO": { "title": "Max Horsepower", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Maximum horsepower" }, "engine_THRUST FROM": { "title": "Min Thrust", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Minimum thrust" }, "engine_THRUST TO": { "title": "Max Thrust", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Maximum thrust" }, "dealer_maxItems": { "title": "Max Items for Dealer Dataset", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of dealer records to collect (optional). Leave empty for unlimited (paid users only). Free users must specify this parameter and are limited to 100 items." }, "dealer_CERTIFICATE-NUMBER": { "title": "Certificate Number", "type": "string", "description": "Enter dealer certificate number to search for. Leave empty to include all certificates." }, "dealer_OWNERSHIP": { "title": "Ownership", "type": "array", "description": "Select ownership types to filter by", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9" ], "enumTitles": [ "Individual", "Partnership", "Corporation", "Co-Ownership", "Government", "Non-Profit", "Other", "Unknown", "Not Specified" ] } }, "dealer_NAME": { "title": "Dealer Name", "type": "string", "description": "Enter dealer name to search for. Leave empty to include all dealers." }, "dealer_CITY": { "title": "City", "type": "string", "description": "Enter city name to search for. Leave empty to include all cities." }, "dealer_STATE-ABBREV": { "title": "State", "type": "string", "description": "Enter state abbreviation (e.g., 'CA', 'TX', 'FL'). Leave empty to include all states." }, "dealer_ZIP-CODE": { "title": "ZIP Code", "type": "string", "description": "Enter ZIP code to search for. Leave empty to include all ZIP codes." }, "dealer_EXPIRATION-FLAG": { "title": "Expiration Flag", "type": "array", "description": "Select expiration flags to filter by", "items": { "type": "string", "enum": [ "Y", "N" ], "enumTitles": [ "Yes", "No" ] } }, "dereg_maxItems": { "title": "Max Items for Deregistered Aircraft Dataset", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of deregistered aircraft records to collect (optional). Leave empty for unlimited (paid users only). Free users must specify this parameter and are limited to 100 items." }, "dereg_N-NUMBER": { "title": "N-Number", "type": "string", "description": "Enter a specific aircraft N-Number to search for (e.g., 'N12345' or '12345'). The 'N' prefix is optional. This dataset contains deregistered/cancelled aircraft." }, "dereg_SERIAL-NUMBER": { "title": "Serial Number", "type": "string", "description": "Enter aircraft serial number to search for. Leave empty to include all serial numbers." }, "dereg_MFR-MDL-CODE": { "title": "Manufacturer Model Code", "type": "string", "description": "Enter manufacturer model code. Leave empty to include all codes." }, "dereg_STATUS-CODE": { "title": "Status Code", "type": "array", "description": "Select status codes to filter by", "items": { "type": "string", "enum": [ "A", "C", "D", "E", "F", "G", "H", "I", "J", "K", "L", "M", "N", "O", "P", "Q", "R", "S", "T", "U", "V", "W", "X", "Y", "Z" ], "enumTitles": [ "Active", "Cancelled", "Deregistered", "Expired", "Forfeited", "Government", "Historical", "Inactive", "Invalid", "Kit", "Limited", "Manufacturer", "Non-Active", "Other", "Pending", "Qualified", "Reserved", "Special", "Temporary", "Unregistered", "Valid", "Withdrawn", "Experimental", "Yearly", "Zero" ] } }, "dereg_NAME": { "title": "Owner Name", "type": "string", "description": "Enter owner name or company name to search for. Leave empty to include all owners." }, "dereg_CITY-MAIL": { "title": "City (Mail)", "type": "string", "description": "Enter city name to search for. Leave empty to include all cities." }, "dereg_STATE-ABBREV-MAIL": { "title": "State (Mail)", "type": "string", "description": "Enter state abbreviation (e.g., 'CA', 'TX', 'FL'). Leave empty to include all states." }, "dereg_YEAR-MFR FROM": { "title": "Year Manufactured From", "minimum": 1900, "maximum": 2030, "type": "integer", "description": "Minimum year of manufacture" }, "dereg_YEAR-MFR TO": { "title": "Year Manufactured To", "minimum": 1900, "maximum": 2030, "type": "integer", "description": "Maximum year of manufacture" }, "docindex_maxItems": { "title": "Max Items for Document Index Dataset", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of document index records to collect (optional). Leave empty for unlimited (paid users only). Free users must specify this parameter and are limited to 100 items." }, "docindex_TYPE-COLLATERAL": { "title": "Type Collateral", "type": "array", "description": "Select collateral types to filter by", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9" ], "enumTitles": [ "Aircraft", "Engine", "Propeller", "Appliance", "Part", "Component", "Accessory", "Other", "Unknown" ] } }, "docindex_COLLATERAL": { "title": "Collateral", "type": "string", "description": "Enter collateral information to search for. Leave empty to include all." }, "docindex_PARTY": { "title": "Party", "type": "string", "description": "Enter party name to search for. Leave empty to include all parties." }, "docindex_DOC-ID": { "title": "Document ID", "type": "string", "description": "Enter document ID to search for. Leave empty to include all documents." }, "docindex_DOC-TYPE": { "title": "Document Type", "type": "array", "description": "Select document types to filter by", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9" ], "enumTitles": [ "Registration", "Bill of Sale", "Security Agreement", "Lien", "Release", "Assignment", "Amendment", "Other", "Unknown" ] } }, "reserved_maxItems": { "title": "Max Items for Reserved N-Numbers Dataset", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of reserved N-Numbers records to collect (optional). Leave empty for unlimited (paid users only). Free users must specify this parameter and are limited to 100 items." }, "reserved_N-NUMBER": { "title": "N-Number", "type": "string", "description": "Enter a specific aircraft N-Number to search for (e.g., 'N12345' or '12345'). The 'N' prefix is optional. This dataset contains reserved N-Numbers." }, "reserved_REGISTRANT": { "title": "Registrant", "type": "string", "description": "Enter registrant name to search for. Leave empty to include all registrants." }, "reserved_CITY": { "title": "City", "type": "string", "description": "Enter city name to search for. Leave empty to include all cities." }, "reserved_STATE": { "title": "State", "type": "string", "description": "Enter state abbreviation (e.g., 'CA', 'TX', 'FL'). Leave empty to include all states." }, "reserved_ZIP CODE": { "title": "ZIP Code", "type": "string", "description": "Enter ZIP code to search for. Leave empty to include all ZIP codes." }, "reserved_TR": { "title": "TR", "type": "array", "description": "Select TR values to filter by", "items": { "type": "string", "enum": [ "Y", "N" ], "enumTitles": [ "Yes", "No" ] } } } }, "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 } } } } } } } } } }