Search articles

HTTP URL Request:

GET: /idata/search

Parameters:

  • App [String]
    Values:
    • finsents
    • bahasa [default]
  • q [String]
    • Supports words as well as queries
      • like ( “word1” OR “word2” ) AND ( “word3” NOT “word4” )
      • or +”word” +”this phrase” -“exclude” AND ( word1 OR word2 OR word3 ) NOT (word4 OR word5)
  • count [number]

Number of results returns. Default value is 50.

  • offset [number]

Result offset. Default value 0.

  • date_max [String]

The maximum date. The format is YYYY-MM-DD. E.g. : 2013-06-01

  • date_min [String]

The minimum date. The format is YYYY-MM-DD. E.g. : 2013-06-01

  • last_update [number]
    • 0 means, there is no valid last updated data.
    • Non zero means current updated data is newer then last updated data
  • region [case insensitive]
    Values:
    • Asia,
    • Europe,
    • Africa,
    • North America,
    • South America,
    • Oceania.

Default all included.

  • category [case insensitive]
    Values:
    • Politics,
    • Economics,
    • Health,
    • Legal,
    • Security,
    • Sports,
    • Technology.

Default all included.

  • timezone
    By default, this API returns data for Europe/Berlin timezone. Users can choose from 3 timezones:
    • America/New_York,
      Asia/Singapore,
      Europe/Berlin.

Examples:

Search for microsoft between 22nd September 2017 and 22nd Octobre 2017.

/search?app=finsents&q=microsoft&date_max=2017-10-22&date_min=2017-09-22

Response:

200 Response will have the JSON structure as below
{ “last_update”: , “data”: { “offset” : < ??? >, count : < >, “total : <>, 

“results” :[{“domain”: < domain name of the article >, “id”: < internal id of the article >, “bloomberg tickers”: [], “source_name”: < Long name of the source>, “title”: < Title of the article >, “category”: [ ]  ,”teaser”: [< Teaser of the article >], “date”: < Article date in dd-mm-yyyy format >, “hms”: < time of the article in hh:mm:ss format >, “url”: < URL of the article >, “region”: [< List of regions identified in article >], “cid”: [ ], “ticker”: [ < List of tickers identified in article > ], “entities”: [< List of entities identified in article >], “source_type”: < Type of source (blog, news etc …) >, “company_names”: [< List of company names identified in article>], “index_names”: [< List of indexes identified in article >]}, 

{ …. < similar content for other articles > }]}, “timezone”: }