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

APIs.io Engineering Platform NewsCategory API

The NewsCategory API from APIs.io Engineering Platform — 1 operation(s) for newscategory.

This API exposes 1 operation across 1 path, and defines 16 schemas. It is described by OpenAPI 3.0.0, at version 2015-07-09.

Requests are made against 4 base URLs: http://apigateway.{region}.amazonaws.com, https://apigateway.{region}.amazonaws.com, http://apigateway.{region}.amazonaws.com.cn, https://apigateway.{region}.amazonaws.com.cn.

1 operations 1 paths 16 schemas 1 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
2015-07-09
Base URL
https://{bucketname}.s3.amazonaws.com
Authentication
API Key
Terms of Service
Resource Areas
1

Authentication & Security 1

APIs.io Engineering Platform NewsCategory API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (hmac). By default, every request must be authenticated.

  • hmac — Amazon Signature authorization v4

Paths & Operations 1

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

NewsCategory 1
GET
/news
APIs.io Engineering Platform The News Category API lets you search on Bing and get back a list of top news articles by category. This section provides technical details about the query parameters and…
News_Category 18 params → 200default

Schemas 16

The contract defines 16 schemas that model the data the API accepts and returns. The most detailed are VideoObject (9 properties), Thing (6 properties), Error (6 properties), Query (5 properties). Each schema is shown below with its type and property counts.

MediaObject
object
Defines a media object.
3 properties
NewsArticle
object
Defines a news article.
3 properties
ErrorResponse
object
The top-level response that represents a failed request.
1 property 1 required
ResponseBase
object
Response base
1 property 1 required
SearchResultsAnswer
object
Defines a search result answer.
1 property
CreativeWork
object
The most generic kind of creative work, including books, movies, photographs, software programs, etc.
4 properties
ImageObject
object
Defines an image
1 property
Identifiable
object
Defines the identity of a resource.
1 property
Thing
object
Defines a thing.
6 properties
VideoObject
object
Defines a video object that is relevant to the query.
9 properties
Article
object
1 property
Error
object
Defines the error that occurred.
6 properties 2 required
Query
object
Defines a search query.
5 properties 1 required
News
object
Defines a news answer.
2 properties 1 required
Answer
object
Defines an answer.
1 property
Response
object
Defines a response. All schemas that could be returned at the root of a response should inherit from this
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

engineering-platform-newscategory-api-openapi.yml Raw ↑