News List
News List Endpoint
Get a list of news related to specific assets or within a specified time range.
Endpoint URL
GET /api/v2/news/list
Description
This endpoint allows users to retrieve news items related to specific assets or all news within a specified time range. Each news item includes information such as title, content summary, publication time, publisher, and original link.
Request Parameters
Query Parameters
Parameter | Type | Required | Default | Description |
---|---|---|---|---|
from_date |
datetime | Yes | - | Start date for filtering news |
to_date |
datetime | Yes | - | End date for filtering news |
full_symbol |
string | No | - | Full symbol format to specify an asset, e.g., “STOCK:US:TSLA” |
sort |
string | No | “asc” | Sort direction (“asc” or “desc”) |
limit |
integer | No | 100 | Number of results to return (default 100, max 1001) |
next_page_key |
string | No | null | Pagination key for fetching next page of results |
secret_key |
string | Yes | - | Your API key |
Response
Response Fields
Field | Type | Description |
---|---|---|
status |
string | Request status (“ok” or “error”) |
code |
integer | HTTP status code |
message |
string | Status message |
reference |
string | Reference ID (null if not applicable) |
result |
object | Result object |
Result Object Fields
Field | Type | Description |
---|---|---|
next_page_key |
string | Key for fetching the next page of results |
next_page_url |
string | Complete URL for fetching the next page |
count |
integer | Number of results in the current response |
data |
array | Array of news information |
News Information Fields
Field | Type | Description |
---|---|---|
sentiment_label |
string | Sentiment label (may be null) |
asset_name |
string | Asset class name |
country_iso_code |
string | Country ISO code |
symbol |
string | Asset symbol |
link_type |
string | Link type (e.g., “SPECIFIC_ASSET”) |
published_date |
string | Publication date and time (ISO 8601 format) |
publisher |
string | Publisher (news source) |
title |
string | News title |
text_content |
string | News content summary |
publisher_url |
string | Original news link |
sentiment_score |
float | Sentiment analysis score (may be null) |
Request Example
GET https://default.dataset-api.aitrados.com/api/v2/news/list?from_date=2025-07-01+00%3A00%3A00&to_date=2025-12-31+00%3A00%3A00&full_symbol=stock%3AUS%3ATSLA&sort=asc&limit=100&secret_key=your-secret-key
Response Example
{
"status": "ok",
"code": 200,
"message": "success",
"reference": null,
"result": {
"next_page_key": "921caf51346003d13bfc0249c172242a897dd88ed289bcbe8d851cbd09e6d76e",
"next_page_url": "https://default.dataset-api.aitrados.com/api/v2/news/list?from_date=2025-07-01+00%3A00%3A00&to_date=2025-12-31+00%3A00%3A00&full_symbol=stock%3AUS%3ATSLA&sort=asc&limit=2&secret_key=your-secret-key&next_page_key=921caf51346003d13bfc0249c172242a897dd88ed289bcbe8d851cbd09e6d76e",
"count": 2,
"data": [
{
"sentiment_label": null,
"asset_name": "stock",
"country_iso_code": "US",
"symbol": "TSLA",
"link_type": "SPECIFIC_ASSET",
"published_date": "2025-07-01T02:57:14+00:00",
"publisher": "reuters.com",
"title": "Tesla registrations in Denmark fall 61.6% year-on-year in June",
"text_content": "Tesla's registration of new cars in Denmark fell by 61.57% in June from the same month a year ago to 1,282 vehicles, registration data from Mobility Denmark showed on Tuesday.",
"publisher_url": "https://www.reuters.com/business/autos-transportation/tesla-registrations-denmark-fall-616-year-on-year-june-2025-07-01/",
"sentiment_score": null
},
{
"sentiment_label": null,
"asset_name": "stock",
"country_iso_code": "US",
"symbol": "TSLA",
"link_type": "SPECIFIC_ASSET",
"published_date": "2025-07-01T03:49:51+00:00",
"publisher": "reuters.com",
"title": "Tesla sales drop over 60% in Sweden and Denmark",
"text_content": "Tesla's sales dropped for a sixth straight month in Sweden and Denmark in June, underscoring the challenges the EV-maker faces as competitors gain market share and CEO Elon Musk's popularity declines.",
"publisher_url": "https://www.reuters.com/business/autos-transportation/tesla-sales-drop-over-60-sweden-denmark-2025-07-01/",
"sentiment_score": null
}
]
}
}
Code Examples
Python
import os
from aitrados_api import ClientConfig
from aitrados_api import DatasetClient
config = ClientConfig(
secret_key=os.getenv("AITRADOS_SECRET_KEY","YOUR_SECRET_KEY"),
)
client = DatasetClient(config=config)
# Get news list
for news_list in client.news.news_list(full_symbol="stock:US:TSLA", from_date="2025-07-01", to_date="2025-12-31", limit=100):
print(news_list)
Notes
-
The time range parameters
from_date
andto_date
are required to limit the number of news items returned. It is recommended to use a reasonable time range for optimal performance. -
The
full_symbol
parameter is optional. If provided, the API will return news related to the specified asset; if not provided, the API will return all news within the time range. -
Sentiment analysis fields
sentiment_label
andsentiment_score
provide analysis of the news sentiment, which can be used to quantify the potential impact of news on the market. These fields may be null, indicating that sentiment analysis has not been performed. -
The news content (
text_content
) is typically a summary or the first few paragraphs of the original news. For the full content, you can access the original news link viapublisher_url
. -
When retrieving large amounts of data using pagination, you can use the
next_page_key
ornext_page_url
from the response to fetch the next page of results. -
This API’s data sources include multiple well-known financial news providers, such as Reuters, Bloomberg, etc., providing high-quality market-related news.