Accessing Data Collected by ADS-B Exchange

In addition to the browsable map of real-time data, ADS-B Exchange is also making available historical and real-time data for personal/non-profit use at a very low cost.  If you find this data useful, or just want to see it’s distribution continue, we greatly appreciate any donations, especially monthly recurring donations to fund the ongoing operation of the site. This data would cost a significant amount of money to buy elsewhere, and would not include all military, all block listed, and all block requested aircraft.

As noted in the legal terms and conditions, commercial use requires written authorization from ADS-B Exchange.  This is necessary to ensure operating this site remains financially viable so we can continue to provide the service.  We may ask that certain commercial users contribute financially to the operation of this site if they desire to use the data in revenue-generating products.

This service could end at any time if the cost to provide it outweighs incoming revenue/donations.  Please keep that in mind when downloading data/using this service – go easy on the infrastructure if you can. There are very real hosting/bandwidth/storage costs for a large and growing data archive such as we have at ADSBx.

Attention Developers!  Please contact us to use the API in your public app.  We will publish a blog post about our app, if you would like us to do so.  We will also work with you to provide the data you require in the most cost efficient way for ADSBx.

 


Querying Live Position Data

Live position data can be queried with various parameters are results returned in a JSON format.

Requirements for REST API data access:

  1. Hosting a feeder sending data to ADSBx. instructions ] [ ADSBx Pi image ] [ FlightAware + ADSBx ]
  2. You are a non-commercial personal user for research, and/or personal knowledge.
  3. REST API requires authorization key.  Contact ADSBexchange to get a key.

 

ADSBx REST API request format

All Aircraft

https://adsbexchange.com/api/aircraft/json/

All Aircraft within x NM of point located at latitude, longitude ( 37.1661, -119.44944 )

https://adsbexchange.com/api/aircraft/json/lat/37.16611/lon/-119.44944/dist/10/

Aircraft with ICAO hex code

https://adsbexchange.com/api/aircraft/icao/A686AD/

Aircraft(s) broadcasting a squawk code

https://adsbexchange.com/api/aircraft/sqk/3522/

Aircraft(s) with ADSBx community registration information

https://adsbexchange.com/api/aircraft/registration/57-1469/

Aircraft tagged by ADSBx community as Military

https://adsbexchange.com/api/aircraft/mil/

 

More REST API Filters coming soon.

  • interesting (user tag)
  • filter by altitude
  • filter by speed

 

This is a good way to get LIVE data.  If you want historical, do NOT call this JSON repeatedly and store it.  Instead, see below!

 


Historical Data (by date/time)

If you want to download a historical record of all data received by ADSBexchange, this is the section for you.

Requirements for JSON Historical Data Access:

  1. Hosting a feeder sending data to ADSBx. [instructions]
  2. You are a non-commercial personal user for research, and/or personal knowledge.
  3. Donation for JSON Data is 0.15 USD per GB to cover bandwidth and storage costs.

Each day is approximately 10-14 GB, thus 1 day is approximately $1.50-$2.10 USD to download. [donate here]

ADSBx requires all academic researchers cover the cost of ingest, aggregation, download, and storage for their use.  If you are and academic researcher with an official email, contact ADSBx for an agreement.

ADSBexchange.com requires that all qualifying academic researchers donate to cover infrastructure costs to ingest, aggregate, and archive the data set.  This is not optional due to the cost of this data and the cost of infrastructure to support the archive.

Data is available beginning on June 9, 2016.

If you meet all 3 requirements, you can request access to download the JSON archive historical files here.

Please explain your use, commercial or non-commercial or otherwise and intentions for the data, and how many days of data and how often you would like to download.  An account will be created and you will receive an email with information.   ADSBx requires that all published work using ADSBx data credits ADSBexchange.com or ADSBexchange, LLC for providing the data.

All use other the personal non-commercial must have a commercial data license agreement.

 

How the data is created:

Building on the “Querying Live Data” section above, essentially, every 60 seconds, we issue the following JSON query and store the results: http://public-api.adsbexchange.com/VirtualRadar/AircraftList.json?trFmt=sa

Essentially, this is a JSON of all aircraft, with “short trails” activated. The short trail duration used in the historical data archive is 65 seconds.  This gives all the current information on the aircraft, plus any known positions, altitudes and timestamps for the previous 65 seconds.  Since this query is issued every 60 seconds, all known positions should be captured in the data. Please consult this page for an explanation of data field contents.

This file is captured every 60 seconds, typically on the 30-second mark of any given minute. This generates 1,440 files daily, which then get zipped into a single archive per day.  The archive for the previous day is typically available by 0100Z (01:00 UTC) the following day. Data is available beginning on June 9, 2016. Daily files are currently in the neighborhood of 10 GB each.

Transfer rates may be somewhat limited depending on the latency of your connection.

JSON Download URL request format:

http://history.adsbexchange.com/Aircraftlist.json/2016-06-20.zip

Simply extrapolate the pattern for any subsequent date.

For a full explanation of fields: https://www.adsbexchange.com/datafields

 


Historical Data (by specific aircraft/ICAO codes)

While this data is contained in the JSON files discussed above, it is not easily searchable for a single aircraft.  Historical data for specific aircraft can be searched here: https://flight-data.adsbexchange.com/. The server for these queries is our AWS data warehouse (described below).

 


SQL Query-able Amazon Redshift Database

Amazon Redshift is based on PostgreSQL. The data contained in the JSON files discussed above is also loaded into an Amazon Redshift database that can be queried with SQL syntax, or linked to any number of data analysis tools such as Tableau, redash.io, chartio, Microsoft Power BI, and more.

The ADSBexchange Amazon Redshift database can be queried directly via the internet. Click here for instructions on how to connect.

While Amazon Redshift contains the data already available in the JSON files discussed above, storing, indexing, and making this data available via Redshift does carry a non-trivial financial cost to ADSBexchange. Access to our Redshift database has an associated cost.  If you have a personal, non-profit, or commercial use in mind, please contact us for more information on getting access.

Click here for a description of some of the fields available to query.  There are nearly 13 billion records and counting.

Redshift access is available on a pay per use model to cover cluster costs, bandwidth, and maintenance.  Contact for more information.



Stay informed about the ADS-B Exchange Data API

Email Address:   

Usage: