Skip to content

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.