Documentation

Before we begin:

  • Please register to obtain an API key.
  • All endpoints are prefixed with: https://stocknewsapi.com
  • Parameter values must be comma-delimited when requesting multiple tickers.
  • For example: ?tickers=AMZN,fb is correct.
  • Casing does not matter when passing values to a parameter.
  • For example: ?tickers=fb and ?tickers=FB will work.

    Get ticker news

    /api/v1?tickers=TSLA&items=5&fallback=true&token=API_KEY

  • ?tickers=TSLA
  • Obtain news about a specific company. In this example TSLA is the symbol for Tesla. This parameter is required.

  • ?tickers=TSLA,AMZN,FB
  • Seperate the symbols by a comma to retrieve news from multiple companies. Please note that this parameter is only available with subscription plans.

  • &type=video or &type=article
  • Use these parameters if you want to obtain only video news or article news. No need to add this parameter if you would like to have both types.

  • &items=5
  • Number of news items returned. Items value must be bewteen 1 and 50. This parameter is required.

  • &fallback=true
  • Fallback returns general stock news in the case that a specific company doesn't have any news associated with it. This improves the User Experience by avoiding empty news. This parameter is optional.

  • &token=API_KEY
  • Change "API_KEY" for your 40 charachter key. This parameter is required.

    "title":"Why SpaceX and Blue Origin are competing with China",
    "news_url":"https://www.youtube.com/watch?v=h8drXDtPzPY",
    "image_url":"https://stocknewsapi.com/images/videos/h/8/h8drxdtpzpy.jpg",
    "sentiment":"Positive",
    "type":"Video",
    "text":"Elon Musk's SpaceX and Jeff Bezos' Blue Origin have long dominated...",
    "source_name":"CNBC",
    "date":"2019-02-15",
    "tickers":["TSLA"]

    Get category news

    This endpoint is available for subscribers only.

    /api/v1/category?section=general&items=5&token=API_KEY

  • ?section=general
  • General news about the market - not company specific. Section parameter is required.

  • ?section=alltickers
  • The latest posted news for all tickers. This parameter shows all news that is posted under specific companies.

  • &type=video or &type=article
  • Use these parameters if you want to obtain only video news or article news. No need to add this parameter if you would like to have both types.

  • &items=5
  • Number of news items returned. Items value must be bewteen 1 and 50. This parameter is required.

  • &token=API_KEY
  • Change "API_KEY" for your 40 charachter key. This parameter is required.

    "title":"Uber pushes back against New York City",
    "news_url":"https://www.youtube.com/watch?v=DJba5ZiI2mE",
    "image_url":"https://stocknewsapi.com/images/videos/d/j/djba5zii2me.jpg",
    "sentiment":"Positive",
    "type":"Video",
    "text":"Uber Technologies Inc. revenue growth slowed and losses persisted in the fou...r",
    "source_name":"Bloomberg Technology",
    "date":"2019-02-15",

    Support

    If you find any issues with our API or have any questions, please contact us.