This site uses cookies to personalise content, adverts, and to analyse traffic. Learn More

News API Documentation

This is the documentation to access the News API. It returns the news articles that we post on the website.

The API Platform is only available via a REST API, in which you have to let your application grab a URL with parameters and it returns all output in either JSON format. This makes it easy to grab the data using any Programming Language of your choice.

The root URL for the API is:

GET https://aviation.flights/api/news

Rate Limits

For the longest time it didn't need to be done but as of February 4, 2025 there is now a temporary rate limit of one request per 5 seconds.

Required Header Request

The following header is required on all requests:

x-api-key: The API key provided to you

Optional URL Parameters

The following parameters are all optional:

Parameter

Description

Use it to search for specific news articles by keywords on its title (i.e. fia2024 or United Airlines)

limit

The number of items being shown in the format: start,end. (i.e. 0,10 to show the first 10 results). Max results is 50.

Output Values for JSON

The following output values are returned after successful query:

Field

Description

news_id

The ID of the News article

title

The title of the News article

news_url

The external URL of the News article

news_source

The source where the news article came from

aircraft_family

The aircraft family the news article is referring to (if available)

msn

The Aircraft MSN number the news article is referring too (if available)

line_number

The Aircraft line number the news article is referring too (for Boeing) (if available)

airline

The Airline name the news article is referring too (if available)

url_to_aircraft

The full URL to the Aircraft on Aviation Flights (if available)

commercial

if set to true then the news article is referring to commerical division

commercial

if set to true then the news article is referring to commerical division

defence

if set to true then the news article is referring to defence division

date_time

The date & time the news article got posted on Aviation Flights, in 'Y-m-d hh:mm:ss' format.

Error Codes for JSON

The following are all error codes that can be returned with this function:

Error Message

Description

No API key provided!

No API key has been provided.

API key invalid!

The API key is invalid.

Sample Output

{
    "status": "success",
    "results": [
        {
            "news": [
                {
                    "news_id": "449",
                    "title": "Berniq Airways orders 6 A320neo's #fia2024",
                    "news_url": "https://www.airbus.com/en/newsroom/press-releases/2024-07-berniq-airways-orders-six-a320neo-family-aircraft-to-support-growth",
                    "news_source": "Airbus",
                    "aircraft_family": "A320",
                    "msn": "",
                    "line_number": "",
                    "airline": "Berniq Airways",
                    "url_to_aircraft": "",
                    "commercial": true,
                    "defence": false,
                    "date_time": "2024-07-23 18:07:44"
                }
            ]
        }
    ]
}

Chat