Stock News API - Analyst Ratings, Earnings Calendar, Benzinga

Pull stock market news, analyst ratings and price targets, consensus ratings, and the earnings, dividend, IPO, guidance, economic, conference call, split, M&A and secondary offering calendars from the Benzinga API into a dataset, a spreadsheet or a warehouse. Uses your own Benzinga API key, reads only, and charges only for rows that carry data.

What it collects

• Stock news: headline, teaser or full body, author, created and updated times, URL, image, the tickers in the article, channels, tags and importance rank. Filter by tickers, channels (including WIIM, why is it moving), topics, authors, date range or last update.
• Analyst ratings: upgrades, downgrades, initiations, reiterations and price target changes with firm, analyst name and ID, current and prior rating, current and prior price target (also split adjusted), percent change, importance and links. Filter by tickers, dates, action and importance.
• Consensus ratings: per ticker, the consensus rating and score, consensus, high and low price targets, the strong buy, buy, hold, sell and strong sell distribution as counts or percentages, and total and unique analyst counts.
• Earnings calendar: report date and time, period, EPS and revenue actuals, estimates, prior values and surprises, with confirmation flags.
• Dividends calendar: dividend amount, prior dividend, yield, frequency, type, and the announced, ex, record and payable dates.
• IPO calendar: pricing date, price range, offer price, open price, shares offered, deal status, market cap at offer, lead and other underwriters, lockup and quiet period dates, and the SEC filing link.
• Guidance: EPS and revenue guidance ranges with prior ranges and estimates, by period, primary or secondary.
• Economic calendar: indicators by country and category with actual, consensus and prior values.
• Conference calls, stock splits, M&A and secondary offerings: call times, dial-in and webcast links; split ratios and ex, record and distribution dates; acquirer, target, deal size, payment type and status; offering shares, price and proceeds.
• Read only, pay per result, bring your own key.

How to use it

1. Get a Benzinga API key with a Benzinga API licence that covers the data you want (news, ratings, calendars). The data you can read is what your licence includes.
2. Paste the key into the API key field (stored as a secret), or set the DATA_API_KEY environment secret on the actor.
3. Pick What to read, list your Tickers (or leave them empty for the whole market), set a date range or filters, and start the run.

A run without a key ends cleanly with a message asking for one, before any request is sent.

Input

Field	What it does
What to read	News (default), analyst ratings, consensus ratings, earnings, dividends, IPOs, guidance, economic calendar, conference calls, splits, M&A or secondary offerings.
Tickers	Stock tickers, one per line, sent 50 to a request. Required for consensus ratings, optional elsewhere, not used by the economic calendar.
Start date, End date	YYYY-MM-DD range for every mode. Without dates the calendars return the latest records and news the newest articles.
Updated since	Unix timestamp for incremental pulls of records updated since your last run.
Minimum importance	0 to 5 on ratings, earnings, dividends, guidance, splits, M&A and offerings; 1 to 3 on the economic calendar.
News text, News channels, News topics, Topic match, News authors, News sort order	News filters and output.
Rating action, Simplify ratings	Analyst ratings filters; simplify also applies to consensus ratings.
Consensus aggregate type	Rating distribution as counts or percentages.
Dividend date field, Split date field, M&A date field	Which date the calendar sorts or filters by.
Guidance type	Primary, secondary or all guidance.
Country, Economic event categories	Economic calendar filters.
Maximum results	Row cap for the whole run.
Requests per minute	Pacing.
API key	Your Benzinga API key, as a secret.

Access and limits on the Benzinga side

• Every route reads only the data sets your Benzinga licence includes. A data set outside your plan answers 403, and the run ends with a message saying it is not on your plan.
• News pages hold up to 100 articles and calendar pages up to 1000 records; the actor follows the page offset with the same filters until a page comes back short or your maximum is reached. Each request takes at most 50 tickers.
• The provider rate limits by licence and answers 429 when the limit is hit; the actor waits and retries.
• A calendar query that matches nothing returns one free row with found set to false and a note, so you can tell an empty result from a failed one.
• Your Benzinga licence agreement decides what you may do with the data. Benzinga licenses its news and calendar data for the uses named in your agreement; displaying or redistributing it to others usually needs a separate licence. This actor does not change those terms.

FAQ

What is the Benzinga API?

Benzinga is a financial media and data company. Its APIs at api.benzinga.com serve the Benzinga newsfeed, analyst ratings, consensus ratings, and calendars for earnings, dividends, IPOs, guidance, economics, conference calls, splits, M&A and secondary offerings, documented at docs.benzinga.com. This actor wraps those read routes. The docs and the live host were checked on 2026-10-06.

Do I need a Benzinga account?

Yes. This actor is bring-your-own-key and never ships one. Use the API key Benzinga issues with your API licence. A missing or refused key ends the run cleanly with a message saying which it was, and a data set your plan does not include is reported the same way.

How do I get analyst upgrades and downgrades for a list of stocks?

Pick analyst ratings, list the tickers, set a start and end date, and optionally set the rating action to Upgrades or Downgrades. Each row is one rating action with the firm, analyst, old and new rating, and old and new price target.

How do I get the earnings calendar for next week?

Pick earnings calendar, leave the tickers empty, and set the start and end dates to next week. Each row is one company report with date, time, period and EPS and revenue estimates; past reports also carry actuals and surprises.

How do I get the latest news for a ticker?

Pick news, list the ticker, and choose headline only, teaser or full body. Add channels, topics or a date range to narrow it, or set updated since to pull only what changed since your last run.

What is the consensus price target?

The consensus ratings mode returns, for one ticker at a time, the consensus rating, the average price target across analysts, the high and low targets, and how many analysts rate it strong buy, buy, hold, sell or strong sell.

Is my key safe?

The key is sent as the token parameter that the provider's API definition declares, is never logged, and is stripped from any error text.

How is it priced?

Pay per result: a low price per calendar event, a little more per analyst rating and news article, and the most per consensus rating, since one row summarises every analyst on a ticker. Requests that find nothing are free. Your Benzinga licence applies separately.

Example output

{
  "mode": "ratings",
  "modeLabel": "Analyst ratings",
  "recordType": "rating",
  "identifier": "MNDY",
  "found": true,
  "id": "695c16678f047b0001fee512",
  "ticker": "MNDY",
  "name": "Monday.Com",
  "date": "2026-01-05",
  "value": "260.0000",
  "title": "Jefferies Maintains Buy",
  "url": "https://www.benzinga.com/stock-articles/MNDY/analyst-ratings",
  "action_company": "Maintains",
  "action_pt": "Lowers",
  "adjusted_pt_current": "260.00",
  "adjusted_pt_prior": "300.00",
  "analyst": "Jefferies",
  "analyst_id": "57fe0358ac6af40001334e62",
  "analyst_name": "Brent Thill",
  "currency": "USD",
  "exchange": "NASDAQ",
  "importance": 3,
  "pt_current": "260.0000",
  "pt_pct_change": "-13.33",
  "pt_prior": "300.00",
  "rating_current": "Buy",
  "rating_prior": "Buy",
  "time": "14:52:07",
  "updated": 1767642765,
  "retrievedAt": "2026-10-06T09:14:52.118Z",
  "note": null
}

Values are illustrative and taken from the provider's documented example. News rows carry title, teaser, body, author, created, tickers, channelNames and tagNames; calendar rows carry every field of their calendar.

Keyword map

stock news API, financial news API, stock market news data, analyst ratings API, price target data, upgrades and downgrades, consensus rating, earnings calendar API, dividend calendar API, IPO calendar data, company guidance data, economic calendar API, stock split calendar, M&A data, secondary offerings data, why is it moving, Benzinga API, Benzinga news export.