Returns articles for tags.

HTTP Request URL:

GET: /idata/get_articles_tag

Parameters:

  • class_nameid [String]

Mandatory parameter. Choose between:

    • Input index id : in_x. E.g. in_9 for SP500, or 
    • Commodity id : cm_x. E.g. cm_151 (also includes crypto-currencies) or 
    • Commodity all : cm_ALL retrieves all commodities or 
    • Commodity Sector : cs_x. E.g. cs_1 or 
    • Forex id : fx_x. E.g. fx_151
  • (alternative) index [String]

Instead of class_nameid=in_x, you may directly specify an index name. E.g.:

https://feed.finsents.com/idata/get_articles_tag?index=SP500

Please refer to static data user guide for more details.

  • (alternative) forex [String]

Instead of class_nameid:=fx_x, you may directly specify the forex pair name. E.g.:

https://feed.finsents.com/idata/get_articles_tag?forex=INR/XAU

Please refer to static data user guide for more details.

  • (alternative) commodity [String]

Instead of class_nameid=cm_x, you may directly specfiy the commodity name. E.g.:

https://feed.finsents.com/idata/get_articles_tag?commodity=GOLD

Please refer to static data user guide for more details.

  • tag [String]

(Optional) Specific tag name in that asset, can get name from get tags api. Returns top articles for one single tag only.

  • count [number]

Number of tags. Return one batch of result by default. Parameter “count” can return several batches of result in reverse time order. Default is 1.

  • timezone [String]

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

    • America/New_York,
    • Asia/Singapore,
    • Europe/Berlin.
  • last_update number values:
    • 0 means, there is no valid last updated data.
    • In case of any non zero value, the response will have valid “data” only if the current data at server is newer than the last updated version reported by the client.

Examples:

https://feed.finsents.com/idata/get_articles_tag?forex=INR/XAU

https://feed.finsents.com/idata/get_articles_tag?forex=INR/XAU

https://feed.finsents.com/idata/get_articles_tag?commodity=GOLD

Response:

200 Response will have the JSON structure as below
{ “last_update”:  < numerical value. ‘0’ will return current data>, “timezone”: < selected timezone> “data”:[ { “timestamp”: < Unix Timestamp >, “tags” :[“name”: < name of the tag>,  

articles”: [ {“image_name”: , “hms” < hour in readable format  >,  “URL”: < external URL of the article>, “title”: < Title of the article >, “date”: < dd-mm-yyyy >, “doc_id” < internal document id >, “teaser”: < Article Teaser >, “domain” < Domain Name> }, ] }, { … } ] }

400 {“error”:”Invalid params”}
401 {“error”:”Invalid Auth key.”}
500 {“error”:”Something went wrong. Please try again later.”}