Articles
List Articles
get
/api/articles
Parameters
sort
string, in query
Field and direction of the sort.
options:
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
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
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:
options:
authors
, categories
, tags
, featured_image
fields[articles]
string, in query
Comma separated list of article fields to return.
options:
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:
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:
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
options:
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:
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.