Get articles

This endpoint fetches a set of articles meeting specified criteria.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
required

The client ID, e.g. DEMO

string

Page number, zero-indexed, default = 0

string

Page size. It is recommended never to exceed a value greater than 1000 items. Default = 100.

string

Sort parameter. Putting a '-' in front of the parameter will sort descending. Possible values are all the fields being passed in to this query. Default = "-pinned,-publishDate".

boolean

Single page articles only

boolean

Pinned articles only

string

Hero media title. Will match on exact string only.

string

Language code, e.g. "EN"

string

Contains these tags (comma separated), e.g. tags=football,club

string

Tags to exclude (comma separated), e.g. notTags=news,clubs

string

List of article IDs, a comma-delimited list of GUID, e.g. articleId=34f7a684-ea95-488e-95a8-9125b33926f0,ce00de60-e2a7-4c2f-a4fe-c1627fda95e5

string

List of category IDs, each category ID is a GUID (comma separated) e.g. categoryId=ed03f87e-7b5f-4ca0-9673-4589a261c012,348cf624-99fb-4cd3-a81b-e7ea1ac0164f

string

List of category IDs, each category ID is a GUID (Comma separated) e.g. categoryId=ed03f87e-7b5f-4ca0-9673-4589a261c012,348cf624-99fb-4cd3-a81b-e7ea1ac0164f

string

Query by multiple linked IDs. Each source system is separated by ";". The source system and source system IDs are separated by ":". Source system IDs can be a comma separated list. e.g. OPTA_FOOTBALL_PLAYER:9844 will find all articles that are tagged with a source system of OPTA_FOOTBALL_PLAYER AND a source system ID of 9844

string

When querying by multiple 'linkedIds', what logical operator should be used? (Possible values: OR, AND). Default is OR.

Response

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json