US FAA Corporate Jet & Aircraft Owner Lead Finder

NEWAPI22 · Apify Actor newapi22-faa-corporate-aircraft-owners · version 1.0

Find corporate aircraft registrants in the U.S. Federal Aviation Administration's current Releasable Aircraft Database Download, with filters for registrant state, manufacturer/model, aircraft class, engine type and registration-certificate issue date.

This Actor does not identify the current operator, true beneficial owner, owner residence, passenger, contact person or business use of an aircraft. FAA registration is not proof that the aircraft is operated by the named registrant. A "jet" filter identifies fixed-wing aircraft with FAA turbojet/turbofan engine codes; it does not establish that an aircraft is a corporate/business jet.

Official data and freshness

• FAA release page: https://www.faa.gov/licenses_certificates/aircraft_certification/aircraft_registry/releasable_aircraft_download
• Daily ZIP: https://registry.faa.gov/database/ReleasableAircraft.zip
• FAA data dictionary (May 8, 2025): https://registry.faa.gov/database/ardata.pdf
• Source tables: MASTER.txt, ACFTREF.txt, ENGINE.txt from the same ZIP download. The actor does not use co-owner names, deregistered-owner records, reserved-number registrants or other files to recover hidden identity information.
• source_file_date is the date in the current MASTER.txt ZIP metadata, which can be one day behind the HTTP Last-Modified date because the FAA refreshes nightly Central Time.
• Full archive SHA-256 and ETag/Last-Modified are recorded in the SOURCE_MANIFEST run key-value record; HTTP conditional GET permits reuse only after an explicit FAA 304 Not Modified and a matching stored SHA. Connection errors never trigger old-copy fallback.
• Only official current ZIP values are emitted. Blank/withheld owner names are excluded; missing/withheld address fields produce null. No historical identity recovery or personal-data enrichment.

Corporate-only privacy control

The current version hard-requires corporateOwnerOnly: true and FAA TYPE REGISTRANT codes 3 (Corporation), 7 (LLC), 8 (Non-citizen corporation). Individual (1), partnership (2), co-owned (4, 9) and government (5) records are never results. Registrant name must be present and not redacted/withheld; this applies even when the FAA marks its type corporate. Addresses are FAA registration/mailing addresses, not verified business offices. This Actor does not infer the address of any registrant.

Input

Input	Description	Default
state	Two-letter FAA registrant mailing state; optional	Any
manufacturerModel	Partial manufacturer or model in FAA aircraft reference table	Any
aircraftClass	jet, turboprop, or all	jet
aircraftType	FAA TYPE AIRCRAFT code; 4 single-engine fixed wing, 5 multi-engine fixed wing, etc.	Any
engineType	FAA TYPE ENGINE code; 2 turboprop, 4 turbojet, 5 turbofan	Any
registrationDateFrom, registrationDateTo	Optional inclusive ISO dates YYYY-MM-DD; specifically FAA CERT ISSUE DATE	Any
corporateOwnerOnly	Must remain true in v1; never export individuals	true
maxResults	Max unique FAA N-number rows (1–5000)	20
costLimitUsd	Maximum output-event spend, USD (0.007–35); result cap also enforced	0.14
timeoutSeconds	Overall download+processing deadline (30–300 s)	240

Example:

{
  "state": "TX",
  "aircraftClass": "jet",
  "manufacturerModel": "CESSNA",
  "corporateOwnerOnly": true,
  "maxResults": 100,
  "costLimitUsd": 0.70,
  "timeoutSeconds": 240
}

Output

One record per unique public current-release FAA N-number:

• n_number — FAA registration N-number.
• serial_number — FAA aircraft serial number.
• aircraft_make_model — merged from MASTER.MFR MDL CODE -> ACFTREF.CODE (full 7-character key).
• engine_type — FAA engine type decoded from MASTER; ENG MFR MDL -> ENGINE.CODE (full 5-character key) is validated.
• owner_company_name — releasable corporate registrant name only; not necessarily operator.
• business_address — current releasable corporate registrant mailing address, null if hidden or incomplete.
• registration_date — FAA certificate issue date, not original acquisition date.
• expiration_date — FAA registration certificate expiration date if present.
• registration_status — current FAA status code plus known description.
• source_file_date, source_url, observed_at — snapshot lineage.

Apify's default Dataset supports JSON and CSV export. The Actor's RUN_SUMMARY and SOURCE_MANIFEST keys provide counts, timestamps, SHA-256 and source metadata. Output is not contact-enriched; no emails, phone numbers, personal/home addresses, operator inference or individual data.

Business model

Pay per event (PPE), synthetic apify-default-dataset-item at $0.007 per result, equivalent to $7 per 1,000 unique aircraft records. Configure only this item event in the Actor's Apify monetization settings, with no additional paid start event, to meet the exact target; no manual per-row charging in source. The actor also enforces costLimitUsd before export and honors platform max-charge limits. Apify commission is 20%; gross $7 / 1000 is not seller net. Seller net = $5.60 less compute/storage/platform costs on qualified paid-user runs. Check live profitability after cloud runs.

Safety and reliability

• HTTPS-only official source, streamed GET with 15 s connect / max 120 s read timeout, 150 MB download ceiling, atomic ZIP replacement and SHA-256 provenance.
• The current download is required. On errors, actor fails closed rather than reusing possibly re-redacted information.
• Python zipfile + csv streams the ~200 MB MASTER entry with bounded memory; references are small dictionaries.
• Strict required-header checks and malformed-row handling; unmatched reference records are skipped, not guessed. In jet/turboprop filtering, the aircraft AND its engine model must both be verifiable and consistent across the current FAA MASTER, ACFTREF and ENGINE tables. FAA class codes without a matching motor reference are excluded (conservative protection against source misclassification).
• Current-release-only N-number deduplication; the Actor does not compare/deduplicate owners across historical ZIPs.
• Minimal 20-item default intended to complete well under five minutes on Apify. Bigger result requests can take longer and have higher total costs.
• No VPN/proxy circumvention, captcha bypass or third-party personal-data enrichment.

Development and QA (Netcup)

cd /opt/NEWAPI/NEWAPI22
python3 -m unittest discover -s tests -v
python3 -m src.local_qa --archive .cache/faa_current.zip \
  --input-json '{"aircraftClass":"jet","maxResults":10,"costLimitUsd":0.07}' \
  --out local-runs/jet.json
python3 -m src.local_qa --archive .cache/faa_current.zip \
  --input-json '{"aircraftClass":"turboprop","maxResults":10,"costLimitUsd":0.07}' \
  --out local-runs/turboprop.json

Cloud image: python:3.12-slim, apify Python SDK and requests. No secrets in repository, images or logs. Source ownership and privacy policy apply to any downstream use.