Articles

List Articles

get

/api/articles

Parameters

sort
string, in query
Field and direction of the sort.
options: -published_at, published_at, -id, id, filter.ids
count
integer, in query
Number of items per page.
defaults to 20 / min: 1, max: 100
links
boolean, in query
Return API links to the included resources. Set to small for a smaller payload.
pagination
boolean, in query
Return pagination data.
page
integer, in query
Page number of results.
defaults to 1
filter[featured_image]
boolean, in query
Only include articles with a featured image.
filter[categories]
csv, in query
Comma separated list of category slugs to gather articles from.
filter[tags]
csv, in query
Comma separated list of tag slugs to gather articles from.
filter[ids]
integers, in query
Comma separated list of articles ids.
includes
string, in query
Comma separated list of relationships to include.
options: authors, categories, tags, featured_image
fields[articles]
string, in query
Comma separated list of article fields to return.
options: title, created_at, updated_at, published_at, permalink, content, excerpt, sort_order, is_ap, is_reuters, is_bloomberg, is_original, is_exclusive, is_breaking, is_commentary, is_update, has_video, has_slideshow, has_people_photo
client
string, in query
The client that is requesting the content.
options: amp

Responses

HTTP code 200
An array of Article objects.
HTTP code 4xx, 5xx
A Fault describing the reason for the error.

Show Article

get

/api/articles/{article}

Parameters

article
required integer, in path
Article ID
client
string, in query
The client that is requesting the content.
options: amp

Responses

HTTP code 200
An Article resource.
HTTP code 4xx, 5xx
A Fault describing the reason for the error.

Most Viewed Articles

get

/api/articles/most-viewed/{range?}

Parameters

range
string, in path
Field and direction of the sort. Defaults to last-7-days
options: last-1-days, last-3-days, last-7-days, last-30-days
count
integer, in query
Number of items per page, defaults to 20.
options: 5, 10, 20, 50, 100
filter[featured_image]
boolean, in query
Only include articles with a featured image.

Responses

HTTP code 200
An array of Article objects sorted by most to least viewed from the range requested.
HTTP code 4xx, 5xx
A Fault describing the reason for the error.