# FAA Aircraft Registry Scraper (`automation-lab/faa-aircraft-registry-scraper`) Actor โœˆ๏ธ Download and filter public FAA aircraft registry records by N-number, owner, state, make, model, engine, and status. - **URL**: https://apify.com/automation-lab/faa-aircraft-registry-scraper.md - **Developed by:** [Stas Persiianenko](https://apify.com/automation-lab) (community) - **Categories:** Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## FAA Aircraft Registry Scraper Extract structured aircraft registration records from the public FAA Civil Aircraft Registry bulk database. This actor downloads the FAA Releasable Aircraft ZIP, joins aircraft and engine reference tables, filters locally, and outputs clean aircraft, owner, address, N-number, make/model, engine, certificate, and status fields. ### What does FAA Aircraft Registry Scraper do? FAA Aircraft Registry Scraper turns the FAA's downloadable registry files into ready-to-use JSON, CSV, Excel, or API data. Instead of manually downloading ZIP files and joining `MASTER.txt`, `ACFTREF.txt`, and `ENGINE.txt`, you can run this actor with simple filters and receive normalized dataset rows. It supports: - โœˆ๏ธ N-number lookup - ๐Ÿงพ Owner / registrant name search - ๐Ÿ“ State, county, and country filters - ๐Ÿญ Manufacturer and model filters - ๐Ÿ”ฉ Serial number filters - โœ… FAA status code filters - ๐Ÿ“ฆ Large bulk exports with `maxItems` ### Who is it for? #### Aviation insurers Build underwriting and renewal lead lists by aircraft type, state, owner name, make/model, and registration status. #### Aircraft lenders and lessors Enrich borrower, collateral, and portfolio data with public aircraft registration metadata. #### Aircraft brokers and dealers Find aircraft owners by state, model, vintage, and registration status for market outreach or inventory research. #### FBO, MRO, and maintenance lead generation teams Create local prospect lists for aircraft owners near target service regions. #### Compliance and OSINT researchers Normalize public FAA registry data for investigations, sanctions screening, safety research, and ownership monitoring. ### Why use this actor? The FAA bulk database is public, but it is not convenient. The files are large, split across reference tables, and use compact codes. This actor automates the boring work: - Downloads the current FAA public ZIP directly from `registry.faa.gov` - Parses the active registry master file - Joins aircraft manufacturer/model references - Joins engine manufacturer/model references - Converts FAA date strings to ISO dates - Emits typed fields with stable names - Charges per saved result, not per scanned row ### What data can I extract? | Field | Description | | --- | --- | | `nNumber` | FAA aircraft registration number | | `serialNumber` | Aircraft serial number | | `uniqueId` | FAA unique registry identifier | | `manufacturer` | Joined aircraft manufacturer | | `model` | Joined aircraft model | | `yearManufactured` | Aircraft manufacture year when available | | `aircraftType` | Decoded aircraft type | | `engineManufacturer` | Joined engine manufacturer | | `engineModel` | Joined engine model | | `ownerName` | Registrant / owner name | | `street`, `city`, `state`, `zipCode` | Registrant address fields | | `country`, `countyCode`, `region` | Registry location codes | | `statusCode` | FAA registration status code | | `certificateIssueDate` | Certificate issue date | | `expirationDate` | Registration expiration date | | `modeSCodeHex` | Mode S hexadecimal code | | `sourceFileDate` | FAA source file date when available | | `scrapedAt` | Actor extraction timestamp | ### How much does it cost to scrape FAA aircraft registry records? This actor uses pay-per-event pricing. You pay a small start fee for each run and then a per-result fee for each aircraft registry record saved to the dataset. Use `maxItems` to control run size during testing and scale up once your filters are correct. ### How to scrape FAA aircraft registry data 1. Open the actor on Apify. 2. Enter one or more filters such as N-numbers, owner name, state, manufacturer, model, or status code. 3. Set `maxItems` to the number of aircraft records you need. 4. Click **Start**. 5. Export results as JSON, CSV, Excel, XML, RSS, or through the Apify API. ### Input options #### N-numbers Use exact N-numbers with or without the leading `N`. Example: `N10001` and `10001` are treated the same. #### Owner name Use a case-insensitive substring. Example: `AIR LLC` matches owners containing that phrase. #### States, counties, and countries Use two-letter state codes, FAA county codes, and country codes such as `US`. #### Manufacturers and models Manufacturer and model filters are matched after joining the FAA aircraft reference table, so you can search names like `CESSNA`, `PIPER`, `BEECH`, or model fragments. #### Status codes Use FAA registry status codes. `V` is commonly used for valid records in the public file. ### Example input ```json { "states": ["TX"], "manufacturers": ["CESSNA"], "statusCodes": ["V"], "maxItems": 100 } ```` ### Example output ```json { "nNumber": "N10001", "serialNumber": "A28", "manufacturer": "WACO", "model": "ASO", "yearManufactured": 1928, "aircraftType": "Fixed wing single-engine", "engineManufacturer": "WRIGHT", "engineModel": "WWJ SERIES", "ownerName": "STOOS ROBERT A", "city": "LAKELAND", "state": "FL", "country": "US", "statusCode": "V", "certificateIssueDate": "2019-02-27", "expirationDate": "2029-02-28" } ``` ### Tips for better results - Start with `maxItems: 100` to validate your filters cheaply. - Use manufacturer + state for regional aviation lead lists. - Use N-number lists for enrichment workflows. - Use owner-name search for portfolio monitoring. - Keep county filters as FAA three-digit county codes. ### Integrations Use this actor with: - CRM enrichment workflows for brokers, lenders, and FBO sales teams - Scheduled monitoring for owner or aircraft status changes - Compliance screening pipelines - Data warehouses and BI dashboards - Google Sheets or Airtable exports through Apify integrations ### API usage with Node.js ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('automation-lab/faa-aircraft-registry-scraper').call({ states: ['TX'], manufacturers: ['CESSNA'], maxItems: 100, }); console.log(run.defaultDatasetId); ``` ### API usage with Python ```python from apify_client import ApifyClient client = ApifyClient('YOUR_APIFY_TOKEN') run = client.actor('automation-lab/faa-aircraft-registry-scraper').call(run_input={ 'states': ['TX'], 'manufacturers': ['CESSNA'], 'maxItems': 100, }) print(run['defaultDatasetId']) ``` ### API usage with cURL ```bash curl -X POST "https://api.apify.com/v2/acts/automation-lab~faa-aircraft-registry-scraper/runs?token=$APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{"states":["TX"],"manufacturers":["CESSNA"],"maxItems":100}' ``` ### MCP usage Use the Apify MCP server with Claude Desktop, Claude Code, or other MCP clients: ```text https://mcp.apify.com/?tools=automation-lab/faa-aircraft-registry-scraper ``` Claude Code setup: ```bash claude mcp add apify-faa-aircraft-registry "https://mcp.apify.com/?tools=automation-lab/faa-aircraft-registry-scraper" ``` Claude Desktop MCP config example: ```json { "mcpServers": { "apify-faa-aircraft-registry": { "url": "https://mcp.apify.com/?tools=automation-lab/faa-aircraft-registry-scraper" } } } ``` MCP example prompts: - "Use the Apify MCP tool automation-lab/faa-aircraft-registry-scraper to find 100 valid Cessna aircraft registered in Texas." - "Use the FAA aircraft registry scraper MCP tool to enrich these N-numbers with FAA owner and aircraft metadata, then return a CSV-ready table." - "Run the FAA aircraft registry scraper through MCP and create a Florida aircraft owner lead list for aviation insurance outreach." ### Data source The actor uses the FAA public Civil Aircraft Registry releasable aircraft database at `https://registry.faa.gov/database/ReleasableAircraft.zip`. It does not require a login, password, private cookie, or paid API key. ### Update frequency FAA bulk files are updated by the source. Each actor run downloads the current public ZIP available from the FAA endpoint at run time. ### Limitations - The actor parses active `MASTER.txt` records from the releasable database. - Deregistered aircraft in `DEREG.txt` are not included in the MVP output. - FAA county values are source codes, not county names. - Some FAA code fields are emitted as source codes when public documentation does not provide a safe display label. ### Legality This actor extracts public government registry data from FAA public download files. You are responsible for using the data lawfully, respecting privacy, honoring applicable marketing rules, and complying with Apify's Terms of Service. ### FAQ #### Does this actor need proxies? No. The actor downloads a public FAA bulk ZIP over normal HTTPS and does not use Apify Proxy. #### Why did my run return fewer records than expected? Your filters may be too narrow, or `maxItems` may be lower than the number of matching records. Try fewer filters or increase `maxItems`. #### Can I search by aircraft model? Yes. The actor joins the FAA aircraft reference file and applies case-insensitive model substring filters. #### Can I enrich a list of N-numbers? Yes. Add your N-numbers to the `nNumbers` input field and set `maxItems` at least as high as the list size. ### Related scrapers - https://apify.com/automation-lab/website-contact-finder - https://apify.com/automation-lab/google-maps-lead-finder - https://apify.com/automation-lab/business-email-finder ### Support If the FAA changes the downloadable database structure or you need additional registry tables such as deregistered aircraft, open an issue on the Apify actor page with a sample input and expected output. # Actor input Schema ## `nNumbers` (type: `array`): Specific FAA registration numbers to return. Accepts values with or without the leading N, such as N10001 or 10001. ## `ownerName` (type: `string`): Case-insensitive substring matched against the FAA registrant/owner name field. ## `states` (type: `array`): Two-letter US state codes from the registrant address, for example TX or FL. ## `counties` (type: `array`): Three-digit FAA county codes from the registry file. ## `countries` (type: `array`): Country codes from the registrant address. Use US for United States records. ## `manufacturers` (type: `array`): Case-insensitive aircraft manufacturer substrings matched after joining FAA ACFTREF.txt. ## `models` (type: `array`): Case-insensitive model substrings matched after joining FAA ACFTREF.txt. ## `serialNumbers` (type: `array`): Case-insensitive serial number substrings. ## `statusCodes` (type: `array`): Filter by FAA status code. V is the common valid registration status in the public file. ## `maxItems` (type: `integer`): Maximum number of matching aircraft records to save to the dataset. ## Actor input object example ```json { "maxItems": 20 } ``` # Actor output Schema ## `overview` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "maxItems": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("automation-lab/faa-aircraft-registry-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "maxItems": 20 } # Run the Actor and wait for it to finish run = client.actor("automation-lab/faa-aircraft-registry-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "maxItems": 20 }' | apify call automation-lab/faa-aircraft-registry-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=automation-lab/faa-aircraft-registry-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "FAA Aircraft Registry Scraper", "description": "โœˆ๏ธ Download and filter public FAA aircraft registry records by N-number, owner, state, make, model, engine, and status.", "version": "0.1", "x-build-id": "ujhR6TDc5NH5Huf1K" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation-lab~faa-aircraft-registry-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation-lab-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/automation-lab~faa-aircraft-registry-scraper/runs": { "post": { "operationId": "runs-sync-automation-lab-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/automation-lab~faa-aircraft-registry-scraper/run-sync": { "post": { "operationId": "run-sync-automation-lab-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 FAA registration numbers to return. Accepts values with or without the leading N, such as N10001 or 10001.", "items": { "type": "string" } }, "ownerName": { "title": "Owner or registrant name contains", "type": "string", "description": "Case-insensitive substring matched against the FAA registrant/owner name field." }, "states": { "title": "Registrant states", "type": "array", "description": "Two-letter US state codes from the registrant address, for example TX or FL.", "items": { "type": "string" } }, "counties": { "title": "FAA county codes", "type": "array", "description": "Three-digit FAA county codes from the registry file.", "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Country codes from the registrant address. Use US for United States records.", "items": { "type": "string" } }, "manufacturers": { "title": "Manufacturers contain", "type": "array", "description": "Case-insensitive aircraft manufacturer substrings matched after joining FAA ACFTREF.txt.", "items": { "type": "string" } }, "models": { "title": "Models contain", "type": "array", "description": "Case-insensitive model substrings matched after joining FAA ACFTREF.txt.", "items": { "type": "string" } }, "serialNumbers": { "title": "Serial numbers contain", "type": "array", "description": "Case-insensitive serial number substrings.", "items": { "type": "string" } }, "statusCodes": { "title": "FAA status codes", "type": "array", "description": "Filter by FAA status code. V is the common valid registration status in the public file.", "items": { "type": "string" } }, "maxItems": { "title": "Maximum aircraft records", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Maximum number of matching aircraft records to save to the dataset.", "default": 20 } } }, "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 } } } } } } } } } } ```