News API Documentation - Introduction

About

The AYLIEN News API is the most powerful way of sourcing, searching and syndicating analyzed and enriched news content. It is accessed by sending HTTP requests to our server, which returns information to your client.

If you haven't already done so, you will need to sign up for a free trial to send requests.

Authorization

Requests to the API must be authorized by adding the headers below, which you receive when you sign up:

  • X-AYLIEN-NewsAPI-Application-ID must be set to your Application ID.
  • X-AYLIEN-NewsAPI-Application-Key must be set to your Application Key.

Usage

You can call the API by sending HTTP POST or GET requests to https://api.newsapi.aylien.com/api/v1 followed by the endpoint name.

As your subscription is based on a story allowance, only requests sent to endpoints that return stories will count towards your allowance. Using the endpoints that return metadata alone does not count towards your allowance, and they are effectively free of charge to subscribers.

To allow our servers to operate best for all of our users, requests from a single user are limited to 3 hits per second and 60 hits per minute on each endpoint.

Endpoints

When you send a request to our servers, you will send it to one of our seven endpoints, and each of these endpoints returns a different type of information. For example, our Stories endpoint returns stories along with data about each story, while the Time series endpoint returns quantitative data on news content over time.

Each endpoint offers dozens of parameters - input fields where you specify your query, making it as detailed as you like. You do not have to fill in information for each parameter, just include parameters that are important to your query.

Since our subscription pricing is based on an allowance of stories, only the stories, related stories, and coverages endpoints count towards this allowance. The autocompletes, time series, trends, and histograms endpoints do not count toward your allowance.

To see what information each endpoint returns, you take a look in the documentation pages or this blog post, or else jump right in and start making queries to them.

SDKs

Integrating with the API is easy using our official SDKs. Grab your SDK from the links below and start making calls.

Postman

If you’re looking for a quick and straightforward way to query the News API, you should consider using Postman or a similar REST client. If you need help with this, take a look at our guide to testing the News API with Postman.