1.2 - get_articles¶
The get_articles function retrieves a list of articles with corresponding data URLs, title, teaser, image etc … for a given list of parameters.
Request¶
| Method | URL |
|---|---|
| GET | idata/get_articles |
Parameters¶
| Params | Values | |
|---|---|---|
| class_nameid | String | The entity whose articles are returned: a prefix and an id, such as c_1389. The prefixes served are: • company [c_id]• index [in_id] • topic [top_id] • source [o_id] • forex [fx_id] • commodity [cm_id], or every commodity [cm_ALL] • crypto currency [cr_id], or every crypto currency [cr_ALL] Several ids of the same kind follow one prefix, separated by commas ( c_1389,35). Commodity sectors (cs_) are not served. Instead of class_nameid, the entity can be named by company, index, forex, crypto or commodity (codes, as for get_sentiment_history) or by topic (a topic name). One of them is required. |
| timezone | String | By default timezone is America/New_York. It sets the day boundary of the dates and the zone of each article's date and time. The possible values are: • America/New_York • Asia/Singapore • Europe/Berlin |
| subclass_nameid | String | Restricts the articles to one theme: tp_competitors, tp_dividend, tp_earnings, tp_products, tp_legals, tp_ma, tp_ecology, tp_governance, tp_social or tp_credit. Any other value is refused with a 400 that lists these. With subclass_nameid, the entity is named by class_nameid only, and the region and category filters can be added. |
| offset | Number | The number of days the window covers, 1 to 365; 0 or no value means 3. With neither date, the window is the last offset days up to now; with start_date alone, from start_date through offset days after it; with end_date alone, from offset days before end_date through end_date. With both dates, offset is ignored. |
| count | Number | The maximum number of articles returned, 1 to 1000, newest first. Without it, every article of the window is returned. |
| start_date | String | The format is YYYY-MM-DD (YYYY/MM/DD is also read). This is the first day of the window, in the time zone given. |
| end_date | String | The format is YYYY-MM-DD (YYYY/MM/DD is also read). This is the last day of the window, included. A start_date after end_date is refused with a 400. |
| last_update | Number | • 0, the default, keeps the whole window. • Above 0, a Unix time in seconds: only the articles published after it are returned. The value is echoed back as last_update. |
Response¶
| Status | Response |
|---|---|
| 200 | Success |
{
“last_update” : <integer timestamp> // value ‘0’ will return current data
"data" : {
"title" : <article title>,
"hms" : <hour:min:sec>,
"teaser" : <teaser>,
"image_name" : <image name>,
"url" : <url>,
"date" : <string in dd-mm-yyyy format>,
"domain" : <domain name>,
"domain_id" : <name id for the domain>,
"sentiment" : <between 1 to 10>,
"relevance": <high, medium, low>
},
{ … }
}
Note (checked against the API on 2026-11-11)¶
The response above is the legacy shape. Today the envelope's Result is {opSuccess, timezone, last_update, name, id, data}: the time zone and last_update used, the name and id of the first entity asked for (absent with subclass_nameid), and the articles, newest first. Each article carries doc_id, title, teaser, date (dd-mm-yyyy) and hms (hh:mm:ss), both in the requested time zone, relevance, sentiment (an integer from 1 to 10), image_name (the URL of the source's logo, not an image of the article), url, domain, timestamp (Unix time in seconds), published_at (the same moment in UTC, ISO 8601), and entities and cid, the entities the article names, as arrays (absent with subclass_nameid). There is no domain_id.
relevance is high (80 or more on a scale of 100) or medium (50 to 79): a company's, topic's, forex pair's, commodity's or crypto currency's articles are returned from relevance 50, an index's from 100. A source's (o_) articles carry no relevance or sentiment.
Every call takes an InfoTrie API key in the X-API-Key header; the legacy AppKey header is refused with a 401. Each operation is served at https://api.infotrie.com/api/idata/ followed by its name.