Message Format

Your socket.io client receives new articles in JSON format as message type articles. Each message is an object:

• articles (array) - array of articles published at the same time. Each element has the same keys as the query API response:
  • id (string) - unique ID of the article
  • title (string) - title of the article
  • description (string) - short description of the article
  • url (string) - URL to original article
  • imageUrl (string, optional) - URL of article thumbnail
  • publishedAt (string) - ISO 8601 formatted date of publication time, e.g. 2020-06-08T12:23:00-04:00
  • source (object) - the source of the article. See the list below for all supported sources.
    • id (string) - unique ID of news source, e.g. businesswire
    • name (string) - human readable name of news source, e.g. BusinessWire
  • symbols (array) - array of ticker symbols mentioned in the article, e.g. AAPL
  • industries (array) - industries of the tickers mentioned in the article.
  • sectors (array) - sectors of the tickers mentioned in the article.

Example Message

{
  "articles": [
    {
      "source": {
        "id": "bloomberg",
        "name": "Bloomberg"
      },
      "symbols": ["MSFT", "COTY"],
      "title": "There Isn’t a Single Down Stock in the S&P Over Last 10 Weeks",
      "content": "",
      "description": "Here’s something to consider with the S&P 500 on the verge of erasing all its 2020 losses: Ever since the benchmark bottomed in March, every single one of its members has posted a positive return.",
      "url": "https://newsfilter.io/articles/there-isnt-a-single-down-stock-in-the-sp-over-last-10-weeks-25a5e721982ce5b75f340c2d30bc7bc3",
      "imageUrl": "https://assets.bwbx.io/images/users/iqjWHBFdfxIU/iFFvjKH9uTwE/v0/-1x-1.png",
      "publishedAt": "2020-06-08T15:50:02Z",
      "id": "25a5e721982ce5b75f340c2d30bc7bc3",
      "industries": [
        "Software - Infrastructure",
        "Household & Personal Products"
      ],
      "sectors": ["Technology", "Consumer Defensive"]
    },
    {
      "source": {
        "id": "bloomberg",
        "name": "Bloomberg"
      },
      "symbols": ["C"],
      "title": "Citigroup Sees Illinois Bonds Already Pricing In Worst Outcome",
      "description": "When it comes to Illinois bonds, Citigroup Inc. says the worst-case-scenario has already been priced in.",
      "url": "https://newsfilter.io/articles/citigroup-sees-illinois-bonds-already-pricing-in-worst-outcome-65c8a53206ed9f030bd4cb18552bdaf0",
      "imageUrl": "https://assets.bwbx.io/images/users/iqjWHBFdfxIU/i4xxGH1AndIg/v2/-1x-1.png",
      "publishedAt": "2020-06-08T15:50:02Z",
      "id": "65c8a53206ed9f030bd4cb18552bdaf0",
      "industries": ["Banks - Global"],
      "sectors": ["Financial Services"]
    }
  ]
}