Read Articles Endpoint
Channel Definition Endpoint: "/news/user/{User_ID}/query"
Note
The {User ID} field is the User ID that was captured as part of the authentication.
Payload:
{
"count": 10,
"offset": 0,
"shouldCluster": true,
"sorting": "time",
}
shouldClusternormally should be true.sortingis based on your preference.- time - Get the latest article at the top of the response.
- trending - count how many times each article has been published and sort based on the most first.
As a default start with time sorting.
Header: (Standard API Header)
{
"x-api-key": "{api_key}",
"Authorization": "{security token}",
"Content-Type": "application/json",
}
The articles will be returned as a JSON string of articles based on the count you used in the Payload.
Advanced
The endpoint only allows 1,000 articles at a time to be read. You can use the offset to get the next 1,000 articles, up to 6,000 articles.
The response structure looks like this:
[
{
"id": 2136069564,
"provider": "B41034DF-6F6F-4662-BFCA-4769B625A073",
"external_id": "14468619455175",
"title": "Trump's Tariffs Are Driving Up Electronics Costs In The US",
"summary": "Why Trump's tariffs have hit the gaming industry so hard US importers of Japanese goods currently face a 15% tariff on products they sell, following Trump's sweeping trade policies implemented since returning to office. \"Similar to many global businesses, we continue to navigate a challenging economic environment,\" Isabelle explains. Elsewhere, Daniel Ahmad, Director of Research & Insight at Niko Partners, suggests that, while Sony has been proactive in taking steps to avoid the impacts of Trump's tariffs, the company has still been affected. The company has tried a number of different strategies to protect itself from the shock of the tariffs, including stockpiling units in the US and diversifying its manufacturing sources. \"With stockpiles running low, the company is making the decision to pass on the cost of these tariffs and additional costs to consumers in the US,\" Daniel explains. ",
"url": "https://technologymagazine.com/news/trumps-tariffs-are-driving-up-electronics-costs-in-the-us",
"published": "2025-08-25T20:48:41.000Z",
"updated": "2025-08-25T20:48:41.000Z",
"created_at": "2025-08-25T20:48:45.076Z",
"updated_at": "2025-08-25T20:48:45.076Z",
"source": 9563323,
"contributor": 9563321,
"author": 11811281,
"headline_cluster": "7xFCYRxXGf92fQZR/bpv9AjPbdBhzke6b/b0Vpm+aik=",
"url_cluster": "4AbsZdninRUN8bfBLRTS9o+fD03r/yj/0gwZyeNky8Q=",
"entities": [
152,
11,
32,
9099716,
119,
62,
35,
57,
222,
22,
9,
130,
16,
20,
612,
2319,
246,
1386,
1588,
12236363,
12236364,
9477831,
9477882,
9633065,
9633062,
12217983,
11382582,
11382583,
11780988,
11966111,
13304496,
3571664,
3571665,
14737,
14711,
37,
14,
19,
3,
13527,
9280420,
9281758,
107637,
13502,
13501,
13579,
6701050,
13549,
13547,
13628,
13555,
10132424,
10132360,
9563321,
9563323,
11811281
],
"primary_entities": [
11,
32,
9099716,
119,
35,
57,
222,
9,
16,
1386,
12236363,
12236364,
9477831,
9477882,
9633065,
9633062,
12217983,
11382582,
11780988,
11966111,
13304496,
14737,
14711,
37,
14,
19,
3,
13527,
107637,
13502,
13501,
6701050,
10132360
],
"secondary_entities": [
130,
20,
246,
9280420,
9281758,
13579,
13549,
13547,
13628,
13555,
10132424
],
"tertiary_entities": [
152,
62,
22,
612,
2319,
1588,
11382583,
3571664,
3571665
],
"image_url": "",
"metadata": {},
"verifications": {}
},
{
"id": 2136069373,
"provider": "B41034DF-6F6F-4662-BFCA-4769B625A073",
"external_id": "14468619449365",
"title": "If a Recession Comes, 4 High-Yield Warren Buffett Stocks Are Safe Havens",
"summary": "If any investor has stood the test of time, it is Warren Buffett, and with good reason. For years,...",
"url": "https://247wallst.com/investing/2025/08/25/if-recession-comes-4-high-yield-warren-buffett-stocks-are-safe-havens/",
"published": "2025-08-25T20:48:27.000Z",
"updated": "2025-08-25T20:48:27.000Z",
"created_at": "2025-08-25T20:48:30.132Z",
"updated_at": "2025-08-25T20:48:30.132Z",
"source": 11273192,
"contributor": 14794,
"author": 0,
"headline_cluster": "sfgWBzdB7e9PNCoqt9i5bDO1uGcnob3xA28u05xyTVs=",
"url_cluster": "VVNbsfN38ez5Zqql3E+fnW/8cHut98fbOdDpStBCqBc=",
"entities": [
1,
2,
6573335,
6573344,
4994294,
2972,
74,
76,
11,
24,
32,
147,
357,
9099716,
298,
443,
77,
212,
196,
75,
35,
57,
222,
608,
51,
16,
3268,
53,
3464,
3780,
246,
757,
3674,
1889,
1253,
55194,
11407307,
11406764,
11406988,
11406796,
11406763,
11382582,
11780988,
13304496,
55,
8,
19,
10132372,
65,
3,
13864,
13527,
7813501,
13502,
13506,
13501,
13579,
13512,
13549,
3093823,
13639,
13863,
13536,
13709,
84888,
13577,
2484987,
10132371,
10132375,
10132362,
10132361,
7628132,
10132385,
13352513,
13812,
14794,
11273192
],
"primary_entities": [
1,
2,
74,
24,
147,
212,
75,
35,
222,
608,
51,
53,
1253,
11382582,
11780988,
13304496,
8,
10132372,
3,
13527,
7813501,
13502,
13501,
3093823,
13536,
13709,
7628132,
10132385,
13812
],
"secondary_entities": [
6573335,
4994294,
2972,
76,
32,
298,
77,
57,
3464,
246,
3674,
1889,
55194,
11406764,
11406763,
13864,
13579,
13512,
13549,
13863,
84888,
10132371,
10132362,
10132361
],
"tertiary_entities": [
6573344,
11,
357,
9099716,
443,
196,
16,
3268,
3780,
757,
11407307,
11406988,
11406796,
55,
19,
65,
13506,
13639,
13577,
2484987,
10132375,
13352513
],
"image_url": "",
"metadata": {},
"verifications": {}
},
{
"id": 2136068821,
"provider": "B41034DF-6F6F-4662-BFCA-4769B625A073",
"external_id": "14468619444025",
"title": "Elon Musk accuses Apple and OpenAI of stifling AI competition in lawsuit",
"summary": "The tech mogul accused Apple of unfairly favouring OpenAI and ChatGPT in its app store rankings.",
"url": "https://www.kidderminstershuttle.co.uk/news/national/25415553.elon-musk-accuses-apple-openai-stifling-ai-competition-lawsuit/?ref=rss",
"published": "2025-08-25T20:46:40.000Z",
"updated": "2025-08-25T20:46:40.000Z",
"created_at": "2025-08-25T20:46:45.053Z",
"updated_at": "2025-08-25T20:46:45.053Z",
"source": 18797,
"contributor": 91446,
"author": 0,
"headline_cluster": "w66vsn29BlXby4F2Ht8iq1zzzlG1vt9jSmeHdFWjZTM=",
"url_cluster": "KZPhTZFBT5sy66oaivikAWOvW/8z646ivHwwyzx4PBg=",
"entities": [
2,
14579,
32,
43,
57,
34,
16,
246,
10595,
12081383,
10154222,
11453958,
11271049,
3571594,
3571636,
3571595,
11382582,
11780988,
13304496,
19,
149,
3,
1721,
1874271,
1874270,
1875200,
1874309,
2661177,
10155893,
10242166,
10807423,
10132357,
10132358,
13512,
3093823,
13744,
13513,
14020,
1949690,
13516,
2307544,
13502,
13506,
13501,
13811,
91446,
18797
],
"primary_entities": [
2,
14579,
32,
43,
57,
34,
16,
246,
10154222,
11453958,
3571594,
3571636,
3571595,
11382582,
11780988,
13304496,
19,
149,
3,
1874309,
2661177,
10155893,
10242166,
10807423,
10132358,
13512,
13744,
13513,
14020,
1949690,
13516,
2307544,
13502,
13506,
13501
],
"secondary_entities": [
10595,
1721,
1874271,
1874270
],
"tertiary_entities": [
12081383,
11271049,
1875200,
10132357,
3093823,
13811
],
"image_url": "",
"metadata": {},
"verifications": {}
}
]
Once you have read the articles, you will need to convert the entity ID's contained in the Primary Entities, Secondary Entities, and Tertiary Entities arrays. That can be done using the look up entities endpoint.
Last update:
September 9, 2025