Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

AYLIEN story API

The story API from AYLIEN — 1 operation(s) for story.

AYLIEN story API is one of 17 APIs that AYLIEN publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include story. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and rate-limit docs.

This API exposes 2 operations across 1 path, and defines 38 schemas. It is described by OpenAPI 3.0.1, at version 3.0.

Requests are made against a single base URL, https://api.aylien.com/news.

2 operations 1 paths 38 schemas 1 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
3.0
Base URL
https://api.aylien.com
Authentication
API Key, API Key
Terms of Service
Resource Areas
1

Authentication & Security 2

AYLIEN story API declares 2 security schemes for authenticating requests. An API key is passed in the header as X-AYLIEN-NewsAPI-Application-ID (app_id). An API key is passed in the header as X-AYLIEN-NewsAPI-Application-Key (app_key).

  • app_id — X-AYLIEN-NewsAPI-Application-ID is the identifier of your server, script, or program with a specific application. This parameter is required if you are accessi…
  • app_key — X-AYLIEN-NewsAPI-Application-Key is the secret key of your server, script, or program with a specific application. This parameter is required if you are access…

Paths & Operations 2

Across 1 path, the API surfaces 2 operations — 1 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

story 2
GET
/stories
List Stories
listStories 113 params → 200401404422429500
POST
/stories
List Stories
advancedListStories 7 params body → 200401404422429500

Schemas 38

The contract defines 38 schemas that model the data the API accepts and returns. The most detailed are Parameter (56 properties), Story (23 properties), Source (11 properties), NestedEntity (9 properties). Each schema is shown below with its type and property counts.

Category
object
7 properties
Logical
array
Logicals
object
3 properties
Error
object
6 properties
EntityLinks
object
3 properties
Entities
object
2 properties
ErrorLinks
object
2 properties
Rankings
object
1 property
Parameter
object
56 properties
EntitySurfaceForm
object
2 properties
Story
object
23 properties
NestedEntity
object
9 properties
Errors
object
1 property
Source
object
11 properties
Sentiments
object
2 properties
EntitySentiment
object
2 properties
Scope
object
4 properties
ScopeLevel
string
The scope by level
Sentiment
object
2 properties
Location
object
3 properties
ShareCount
object
2 properties
StoryTranslations
object
Translations of the story. Each language has it's own key and object
1 property
MediaFormat
string
The format of media
Author
object
3 properties
Media
object
6 properties
SentimentPolarity
string
Polarity of the sentiment
Rank
object
3 properties
Summary
object
1 property
Warning
object
3 properties
Query
object
8 properties
CategoryLinks
object
2 properties
StoryLinks
object
4 properties
ShareCounts
object
4 properties
CategoryTaxonomy
string
The taxonomy of the category
Entity
object
8 properties
Stories
object
5 properties
StoryTranslation
object
2 properties
MediaType
string
The type of media

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

aylien-story-api-openapi.yml Raw ↑

Other APIs AYLIEN publishes across the network.

AYLIEN Absa API
AYLIEN autocomplete API
AYLIEN Classify API
AYLIEN cluster API
AYLIEN Concepts API
AYLIEN Elsa API
AYLIEN Entities API
AYLIEN Extract API
AYLIEN Hashtags API
AYLIEN histogram API
AYLIEN Language API
AYLIEN related_story API