# Benzinga

> Get market-moving news and data from Benzinga: news by ticker and channel, analyst ratings, earnings, dividends, splits, IPOs, guidance, economic releases, M&A, FDA events, unusual options activity, insider filings, congressional trades, quotes and company profiles.

App · 25 actions. Web page: https://docs.lodol.com/docs/integrations/benzinga

## Actions

### Get bull and bear case

Get the latest bull case and bear case Benzinga has written for one stock.

**Inputs**

- Ticker (`ticker`, text, required): One ticker symbol, such as AAPL.
- Page (`page`, number): Which page to get, starting at 0. Benzinga returns at most 10,000 records in all for one search. At least 0.
- Page size (`page_size`, number): How many to return, 1 to 200. Benzinga's default is 100. From 1 to 200.

**Outputs**

- `cases` (list): The bull and bear cases
- `count` (number): How many records this page holds
- `page` (number): The page returned, from 0

**Example output**

```json
{
  "cases": [
    {
      "bear_case": "The analysis highlights a 3.6% year-over-year decline in sales from China, which raises concerns about a key region.",
      "bull_case": "Apple's fourth-quarter sales increased 8% to $102.5 billion, supporting a projected total sales growth of 10% to 12% in the upcoming quarter.",
      "id": "6951d73e304f6ecd69d00189",
      "securities": [
        {
          "cik": "0000320193",
          "exchange": "NASDAQ Global Select Consolidated",
          "isin": "US0378331005",
          "name": "APPLE INC",
          "symbol": "AAPL"
        }
      ],
      "ticker": "AAPL",
      "updated": 1766971198
    }
  ],
  "count": 1,
  "page": 0
}
```

### Get company profile

Get company profiles: what each company does, its address, website, employees and identifiers.

**Inputs**

- Tickers (`symbols`, text, required): One or more ticker symbols separated by commas, such as AAPL, MSFT (up to 50).

**Outputs**

- `count` (number): How many
- `profiles` (list): One profile per company

**Example output**

```json
{
  "count": 1,
  "profiles": [
    {
      "company": {
        "cik": "320193",
        "countryId": "USA",
        "cusip": "037833100",
        "isin": "US0378331005",
        "primaryExchange": "NAS",
        "primarySymbol": "AAPL",
        "standardName": "Apple",
        "yearofEstablishment": 1977
      },
      "companyProfile": {
        "address1": "One Apple Park Way",
        "city": "Cupertino",
        "country": "USA",
        "fiscalYearEnd": "9",
        "homepage": "https://www.apple.com",
        "legalName": "Apple Inc",
        "longDescription": "Apple is among the largest companies in the world, with a broad portfolio of hardware and software products.",
        "phone": "+1 408 996-1010",
        "postalCode": "95014",
        "province": "CA",
        "shortName": "Apple",
        "standardName": "Apple Inc",
        "totalEmployees": 166000
      },
      "id": "AAPL",
      "idType": "SYMBOL",
      "symbol": "AAPL"
    }
  ]
}
```

### Get consensus rating

Get the analysts' consensus rating and price target for one stock, with how many analysts rate it buy, hold or sell.

**Inputs**

- Ticker (`ticker`, text, required): One ticker symbol, such as AAPL.
- From date (`date_from`, date): Only count ratings on or after this date.
- To date (`date_to`, date): Only count ratings on or before this date.
- Count as (`aggregate_type`, text): Count each rating as a number of analysts or a percentage. One of: `number` (Number of analysts (default)), `percentage` (Percentage of analysts).
- Only buy, hold and sell (`simplify`, true/false): Fold strong buy into buy and strong sell into sell.

**Outputs**

- `aggregate_ratings` (object): How many analysts give each rating
- `aggregate_type` (text): number or percentage
- `consensus_price_target` (number): Average target
- `consensus_rating` (text): Such as BUY or HOLD
- `consensus_rating_val` (number): The consensus as a number, 1 (sell) to 5 (strong buy)
- `high_price_target` (number): Highest target
- `low_price_target` (number): Lowest target
- `ticker` (text): The stock
- `total_analyst_count` (number): Ratings counted
- `unique_analyst_count` (number): Analysts counted
- `updated_at` (text): When it was worked out

**Example output**

```json
{
  "aggregate_ratings": {
    "buy": 12,
    "hold": 5,
    "sell": 2,
    "strong_buy": 7
  },
  "aggregate_type": "number",
  "consensus_price_target": 293.69192307692305,
  "consensus_rating": "BUY",
  "consensus_rating_val": 3.923076923076923,
  "high_price_target": 350,
  "low_price_target": 200,
  "ticker": "AAPL",
  "total_analyst_count": 50,
  "unique_analyst_count": 26,
  "updated_at": "2026-01-05T19:42:36Z"
}
```

### Get delayed quotes

Get delayed quotes for up to 50 stocks: last price, change, volume, 52-week range, market cap and P/E.

**Inputs**

- Tickers (`symbols`, text, required): One or more ticker symbols separated by commas, such as AAPL, MSFT (up to 50).

**Outputs**

- `count` (number): How many
- `quotes` (list): One quote per stock

**Example output**

```json
{
  "count": 1,
  "quotes": [
    {
      "askPrice": 272.9,
      "averageVolume": 45744505,
      "bidPrice": 272.61,
      "bzExchange": "NASDAQ",
      "change": -0.88,
      "changePercent": -0.32,
      "close": 273.76,
      "companyStandardName": "Apple Inc",
      "currency": "USD",
      "dividend": 1.04,
      "dividendYield": 0.38,
      "exchange": "XNAS",
      "fiftyTwoWeekHigh": 288.62,
      "fiftyTwoWeekLow": 169.2101,
      "forwardPE": 33.0033,
      "industry": "Technology Hardware, Storage & Peripherals",
      "lastTradePrice": 272.88,
      "lastTradeTime": 1767094765848,
      "marketCap": 4032171206640,
      "name": "Apple",
      "pe": 36.697051,
      "previousClosePrice": 273.4,
      "sector": "Information Technology",
      "symbol": "AAPL",
      "type": "STOCK",
      "volume": 27899
    }
  ]
}
```

### Get news story

Get one Benzinga news story by its id, with its headline, teaser or full text, tickers and channels.

**Inputs**

- Story ID (`news_id`, text, required): The story's id, from 'List news' or an earlier step.
- Story text (`display_output`, text): How much of each story to include. Defaults to the headline only. One of: `headline` (Headline only (default)), `abstract` (Headline and teaser), `full` (Headline and full story).

**Outputs**

- `article` (object): The news story

**Example output**

```json
{
  "article": {
    "author": "Benzinga Insights",
    "body": "",
    "channels": [
      {
        "name": "Options"
      }
    ],
    "created": "Mon, 01 Jan 2024 13:35:14 -0400",
    "id": 36444586,
    "image": [
      {
        "alt": "Applied optoelectronics website",
        "size": "thumb",
        "url": "https://cdn.benzinga.com/files/imagecache/250x187xUP/images/story/2023/options_image_2.jpeg"
      }
    ],
    "stocks": [
      {
        "cusip": "037833100",
        "exchange": "NASDAQ",
        "isin": "US0378331005",
        "name": "AAPL"
      }
    ],
    "tags": [
      {
        "name": "BZI-AUOA"
      }
    ],
    "teaser": "",
    "title": "10 Information Technology Stocks With Whale Alerts In Today's Session",
    "updated": "Mon, 01 Jan 2024 13:35:15 -0400",
    "url": "https://www.benzinga.com/markets/options/24/01/36444586/10-information-technology-stocks-with-whale-alerts-in-todays-session"
  }
}
```

### List analyst ratings

Find analyst upgrades, downgrades, initiations and price target changes by ticker, date, action, firm or analyst. Gets one page; to see more, run it again with the next page.

**Inputs**

- Tickers (`tickers`, text): Only these stocks: one or more ticker symbols separated by commas, such as AAPL, MSFT (up to 50). Leave empty for all.
- From date (`date_from`, date): Only records on or after this date.
- To date (`date_to`, date): Only records on or before this date.
- Action (`rating_action`, text): Only ratings with this action, such as upgrades. One of: `Upgrades`, `Downgrades`, `Maintains`, `Reiterates`, `Initiates Coverage On` (Initiates coverage), `Reinstates`, `Assumes`, `Terminates Coverage On` (Terminates coverage), `Suspends`, `Removes`, `Firm Dissolved`.
- Firms (`firm_ids`, list): Only ratings from these research firms.
- Analysts (`analyst_ids`, list): Only ratings from these analysts.
- Minimum importance (`importance`, text): Only records Benzinga rates at least this important, from 0 (all) to 5. One of: `0` (0 or more (everything)), `1` (1 or more), `2` (2 or more), `3` (3 or more), `4` (4 or more), `5` (5 (most important only)).
- Changed since (`updated_since`, date and time): Only records added or changed at or after this time. Use it to pick up only what is new since an earlier run.
- Page (`page`, number): Which page to get, starting at 0. Benzinga returns at most 10,000 records in all for one search. At least 0.
- Page size (`page_size`, number): How many to return, 1 to 1,000. From 1 to 1000.

**Outputs**

- `count` (number): How many records this page holds
- `page` (number): The page returned, from 0
- `ratings` (list): The ratings

**Example output**

```json
{
  "count": 1,
  "page": 0,
  "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",
      "cusip": "001176213",
      "date": "2026-01-05",
      "exchange": "NASDAQ",
      "id": "695c16678f047b0001fee512",
      "importance": 3,
      "isin": "IL0011762130",
      "name": "Monday.Com",
      "notes": "",
      "pt_current": "260.0000",
      "pt_pct_change": "-13.33",
      "pt_prior": "300.00",
      "rating_current": "Buy",
      "rating_prior": "Buy",
      "ticker": "MNDY",
      "time": "14:52:07",
      "updated": 1767642765,
      "url": "https://www.benzinga.com/quote/MNDY/analyst-ratings",
      "url_calendar": "https://www.benzinga.com/quote/MNDY/analyst-ratings",
      "url_news": "https://www.benzinga.com/stock-articles/MNDY/analyst-ratings"
    }
  ]
}
```

### List analysts

List the analysts Benzinga tracks, with their firm and how accurate their past ratings were. Gets one page; to see more, run it again with the next page.

**Inputs**

- Firms (`firm_ids`, list): Only analysts at these research firms.
- Page (`page`, number): Which page to get, starting at 0. Benzinga returns at most 10,000 records in all for one search. At least 0.
- Page size (`page_size`, number): How many to return, 1 to 1,000. From 1 to 1000.

**Outputs**

- `analysts` (list): The analysts
- `count` (number): How many records this page holds
- `page` (number): The page returned, from 0

**Example output**

```json
{
  "analysts": [
    {
      "firm_id": "57f832a96b87f600016fa347",
      "firm_name": "Morgan Stanley",
      "id": "683d9c45e5343b000101a1e3",
      "name_first": "Lillian",
      "name_full": "Lillian Lou",
      "name_last": "Lou",
      "ratings_accuracy": {
        "smart_score": "2.86",
        "total_ratings": 1
      },
      "updated": 1767619219
    }
  ],
  "count": 1,
  "page": 0
}
```

### List conference calls

Find scheduled earnings and business update calls with their time, dial-in numbers and webcast link. Gets one page; to see more, run it again with the next page.

**Inputs**

- Tickers (`tickers`, text): Only these stocks: one or more ticker symbols separated by commas, such as AAPL, MSFT (up to 50). Leave empty for all.
- From date (`date_from`, date): Only records on or after this date.
- To date (`date_to`, date): Only records on or before this date.
- Changed since (`updated_since`, date and time): Only records added or changed at or after this time. Use it to pick up only what is new since an earlier run.
- Page (`page`, number): Which page to get, starting at 0. Benzinga returns at most 10,000 records in all for one search. At least 0.
- Page size (`page_size`, number): How many to return, 1 to 1,000. From 1 to 1000.

**Outputs**

- `conference_calls` (list): The calls
- `count` (number): How many records this page holds
- `page` (number): The page returned, from 0

**Example output**

```json
{
  "conference_calls": [
    {
      "access_code": "",
      "cusip": "74965L101",
      "date": "2026-02-27",
      "exchange": "NYSE",
      "id": "69455ad26f0e8300014905ae",
      "importance": 2,
      "international_num": "(201) 493-6780",
      "isin": "US74965L1017",
      "name": "RLJ Lodging",
      "notes": "",
      "phone_num": "(877) 407-3982",
      "reservation_num": "",
      "start_time": "10:00:00",
      "ticker": "RLJ",
      "time": "09:01:54",
      "updated": 1766389198,
      "webcast_url": "https://edge.media-server.com/mmc/p/vrgtwapr/"
    }
  ],
  "count": 1,
  "page": 0
}
```

### List congressional trades

Find stock trades disclosed by members of the US House and Senate, by ticker, chamber and date. Gets one page; to see more, run it again with the next page.

**Inputs**

- Tickers (`tickers`, text): Only these stocks: one or more ticker symbols separated by commas, such as AAPL, MSFT (up to 50). Leave empty for all.
- Chamber (`chamber`, text): Only trades by members of the House or the Senate. One of: `House`, `Senate`.
- From date (`date_from`, date): Only records on or after this date.
- To date (`date_to`, date): Only records on or before this date.
- Changed since (`updated_since`, date and time): Only records added or changed at or after this time. Use it to pick up only what is new since an earlier run.
- Page (`page`, number): Which page to get, starting at 0. Benzinga returns at most 10,000 records in all for one search. At least 0.
- Page size (`page_size`, number): How many to return, 1 to 1,000. From 1 to 1000.

**Outputs**

- `count` (number): How many records this page holds
- `page` (number): The page returned, from 0
- `trades` (list): The trades

**Example output**

```json
{
  "count": 1,
  "page": 0,
  "trades": [
    {
      "amendment_number": 0,
      "amount": "$1,001 - $15,000",
      "chamber": "House",
      "description": "Professionally Managed Account.",
      "disclosure_url": "https://disclosures-clerk.house.gov/public_disc/ptr-pdfs/2026/20034496.pdf",
      "filer_info": {
        "chamber": "House",
        "display_name": "Sheri Biggs",
        "district": "3",
        "member_id": "B001325",
        "member_name": "Sheri Biggs",
        "party": "R",
        "state": "SC"
      },
      "id": "6a296077f07735f389b33f69",
      "notification_date": "2026-06-08",
      "ownership": "SP",
      "report_date": "2026-06-09",
      "report_id": "20034496",
      "security": {
        "name": "Alphakeys Blackstone Life",
        "ticker": "",
        "type": ""
      },
      "transaction_date": "2026-04-28",
      "transaction_id": "e3b297fc9ab6ec13d9c099e4edede8ff70de242f",
      "transaction_type": "P",
      "updated": 1781096567
    }
  ]
}
```

### List dividends

Find dividend announcements with their amount, ex-dividend, record and payable dates, by ticker, date or yield. Gets one page; to see more, run it again with the next page.

**Inputs**

- Tickers (`tickers`, text): Only these stocks: one or more ticker symbols separated by commas, such as AAPL, MSFT (up to 50). Leave empty for all.
- From date (`date_from`, date): Only records on or after this date.
- To date (`date_to`, date): Only records on or before this date.
- Date to sort by (`date_sort`, text): Which of the dividend's dates to sort by, newest first. One of: `announced` (Announcement date), `ex` (Ex-dividend date), `payable` (Payable date), `record` (Record date).
- Dividend yield (%) (`dividend_yield`, number): A yield to compare with, as a percentage, such as 5 for 5%. At least 0.
- Yield is (`yield_operation`, text): How each dividend's yield compares with the one given. One of: `gte` (At least), `gt` (More than), `eq` (Exactly), `lte` (At most), `lt` (Less than).
- Minimum importance (`importance`, text): Only records Benzinga rates at least this important, from 0 (all) to 5. One of: `0` (0 or more (everything)), `1` (1 or more), `2` (2 or more), `3` (3 or more), `4` (4 or more), `5` (5 (most important only)).
- Changed since (`updated_since`, date and time): Only records added or changed at or after this time. Use it to pick up only what is new since an earlier run.
- Page (`page`, number): Which page to get, starting at 0. Benzinga returns at most 10,000 records in all for one search. At least 0.
- Page size (`page_size`, number): How many to return, 1 to 1,000. From 1 to 1000.

**Outputs**

- `count` (number): How many records this page holds
- `dividends` (list): The dividends
- `page` (number): The page returned, from 0

**Example output**

```json
{
  "count": 1,
  "dividends": [
    {
      "confirmed": false,
      "currency": "USD",
      "cusip": "33740U620",
      "date": "2026-12-31",
      "dividend": "0.1636",
      "dividend_prior": "0.1636",
      "dividend_type": "Cash",
      "dividend_yield": "",
      "end_regular_dividend": false,
      "ex_dividend_date": "2027-01-04",
      "exchange": "BATS",
      "frequency": 12,
      "id": "6958d4d893cde40001ee2606",
      "importance": 1,
      "isin": "US33740U6203",
      "name": "FT Vest U.S. Equity Buffer & Premium Income ETF - March",
      "notes": "",
      "payable_date": "2027-01-05",
      "period": "JAN",
      "record_date": "2027-01-04",
      "ticker": "XIMR",
      "updated": 1767429336,
      "year": 2027
    }
  ],
  "page": 0
}
```

### List earnings

Find earnings dates and results (EPS and revenue against estimates) by ticker and date. Gets one page; to see more, run it again with the next page.

**Inputs**

- Tickers (`tickers`, text): Only these stocks: one or more ticker symbols separated by commas, such as AAPL, MSFT (up to 50). Leave empty for all.
- From date (`date_from`, date): Only records on or after this date.
- To date (`date_to`, date): Only records on or before this date.
- Minimum importance (`importance`, text): Only records Benzinga rates at least this important, from 0 (all) to 5. One of: `0` (0 or more (everything)), `1` (1 or more), `2` (2 or more), `3` (3 or more), `4` (4 or more), `5` (5 (most important only)).
- Changed since (`updated_since`, date and time): Only records added or changed at or after this time. Use it to pick up only what is new since an earlier run.
- Page (`page`, number): Which page to get, starting at 0. Benzinga returns at most 10,000 records in all for one search. At least 0.
- Page size (`page_size`, number): How many to return, 1 to 1,000. From 1 to 1000.

**Outputs**

- `count` (number): How many records this page holds
- `earnings` (list): The earnings
- `page` (number): The page returned, from 0

**Example output**

```json
{
  "count": 1,
  "earnings": [
    {
      "currency": "USD",
      "cusip": "037833100",
      "date": "2026-10-29",
      "date_confirmed": 0,
      "eps": "",
      "eps_est": "1.990",
      "eps_prior": "1.850",
      "eps_surprise": "",
      "eps_surprise_percent": "",
      "eps_type": "",
      "exchange": "NASDAQ",
      "id": "69030cfb619d3a00015b72a3",
      "importance": 5,
      "isin": "US0378331005",
      "name": "Apple",
      "notes": "",
      "period": "Q4",
      "period_year": 2026,
      "revenue": "",
      "revenue_est": "",
      "revenue_prior": "102466000000.000",
      "revenue_surprise": "",
      "revenue_surprise_percent": "",
      "revenue_type": "",
      "ticker": "AAPL",
      "time": "16:00:00",
      "updated": 1766187011
    }
  ],
  "page": 0
}
```

### List economic events

Find economic releases such as GDP, jobs and inflation figures, with the actual, consensus and prior values, by country and date. Gets one page; to see more, run it again with the next page.

**Inputs**

- Country (`country`, text): Only this country, as a three-letter code such as USA, CAN or GBR.
- Event names (`event_names`, text): Only events whose name starts with one of these, separated by commas. CPI matches CPI (MoM) too.
- Categories (`event_categories`, text): Only these categories, such as Employment, separated by commas.
- From date (`date_from`, date): Only records on or after this date.
- To date (`date_to`, date): Only records on or before this date.
- Minimum importance (`importance`, text): Only events Benzinga rates at least this important, 1 to 3. One of: `1` (1 or more (everything)), `2` (2 or more), `3` (3 (most important only)).
- Changed since (`updated_since`, date and time): Only records added or changed at or after this time. Use it to pick up only what is new since an earlier run.
- Page (`page`, number): Which page to get, starting at 0. Benzinga returns at most 10,000 records in all for one search. At least 0.
- Page size (`page_size`, number): How many to return, 1 to 1,000. From 1 to 1000.

**Outputs**

- `count` (number): How many records this page holds
- `economic_events` (list): The economic events
- `page` (number): The page returned, from 0

**Example output**

```json
{
  "count": 1,
  "economic_events": [
    {
      "actual": "",
      "actual_t": "%",
      "consensus": "",
      "consensus_t": "",
      "country": "USA",
      "date": "2026-03-08",
      "description": "Challenger Job Cuts (YoY) report tracks the percentage change in layoffs reported by employers during a given month.",
      "event_category": "Employment",
      "event_name": "Challenger Job Cuts (YoY)",
      "event_period": "",
      "id": "6745790147f2830001365a27",
      "importance": 1,
      "notes": "",
      "period_year": 2026,
      "prior": "",
      "prior_t": "%",
      "time": "02:30:09",
      "updated": 1736341667
    }
  ],
  "page": 0
}
```

### List FDA events

Find FDA approvals, clinical trial results and PDUFA dates for drug makers, by ticker and date. Gets one page; to see more, run it again with the next page.

**Inputs**

- Tickers (`tickers`, text): Only these stocks: one or more ticker symbols separated by commas, such as AAPL, MSFT (up to 50). Leave empty for all.
- From date (`date_from`, date): Only records on or after this date.
- To date (`date_to`, date): Only records on or before this date.
- Date to filter by (`date_field`, text): Which date the date range applies to: when it was announced (the default) or the FDA's target date. One of: `announced` (Announcement date (default)), `target` (Target date).
- Changed since (`updated_since`, date and time): Only records added or changed at or after this time. Use it to pick up only what is new since an earlier run.
- Page (`page`, number): Which page to get, starting at 0. Benzinga returns at most 10,000 records in all for one search. At least 0.
- Page size (`page_size`, number): How many to return, 1 to 1,000. From 1 to 1000.

**Outputs**

- `count` (number): How many records this page holds
- `fda_events` (list): The FDA events
- `page` (number): The page returned, from 0

**Example output**

```json
{
  "count": 1,
  "fda_events": [
    {
      "commentary": "",
      "companies": [
        {
          "cik": "",
          "id": "62b3773a118ebc0001427b67",
          "name": "Alpha Tau Medical Ltd.",
          "securities": [
            {
              "exchange": "NASDAQ",
              "symbol": "DRTS"
            }
          ]
        }
      ],
      "created": 1767621777,
      "date": "2026-01-05",
      "drug": {
        "generic": false,
        "id": "62b3771c9c3cd100011418ce",
        "indication_symptom": [
          "Prostate cancer"
        ],
        "name": "Alpha DaRT"
      },
      "event_type": "Provided Update",
      "id": "695bc49183cac20001bec514",
      "nic_number": "",
      "notes": "",
      "outcome": "Alpha Tau Medical Ltd. announced the submission of the first module of its pre-market approval (PMA) application to the FDA.",
      "outcome_brief": "",
      "source_link": "https://www.benzinga.com/pressreleases/26/01/g49690927/alpha-tau",
      "source_type": "Press Release",
      "status": "",
      "target_date": "",
      "time": "09:00:00",
      "updated": 1767621823
    }
  ],
  "page": 0
}
```

### List guidance

Find company guidance, the EPS and revenue ranges management expects, by ticker and date. Gets one page; to see more, run it again with the next page.

**Inputs**

- Tickers (`tickers`, text): Only these stocks: one or more ticker symbols separated by commas, such as AAPL, MSFT (up to 50). Leave empty for all.
- From date (`date_from`, date): Only records on or after this date.
- To date (`date_to`, date): Only records on or before this date.
- Which guidance (`primary`, text): Primary, secondary or all guidance. Defaults to primary. One of: `Y` (Primary guidance only (default)), `N` (Secondary guidance only), `All` (All guidance).
- Minimum importance (`importance`, text): Only records Benzinga rates at least this important, from 0 (all) to 5. One of: `0` (0 or more (everything)), `1` (1 or more), `2` (2 or more), `3` (3 or more), `4` (4 or more), `5` (5 (most important only)).
- Changed since (`updated_since`, date and time): Only records added or changed at or after this time. Use it to pick up only what is new since an earlier run.
- Page (`page`, number): Which page to get, starting at 0. Benzinga returns at most 10,000 records in all for one search. At least 0.
- Page size (`page_size`, number): How many to return, 1 to 1,000. From 1 to 1000.

**Outputs**

- `count` (number): How many records this page holds
- `guidance` (list): The guidance updates
- `page` (number): The page returned, from 0

**Example output**

```json
{
  "count": 1,
  "guidance": [
    {
      "currency": "USD",
      "date": "2026-01-05",
      "eps_guidance_est": "",
      "eps_guidance_max": "",
      "eps_guidance_min": "",
      "eps_guidance_prior_max": "",
      "eps_guidance_prior_min": "",
      "eps_type": "",
      "exchange": "NASDAQ",
      "id": "695bcc0c83cac20001becbd4",
      "importance": 1,
      "is_primary": "Y",
      "name": "RedCloud Holdings",
      "notes": "",
      "period": "FY",
      "period_year": 2026,
      "prelim": "Y",
      "revenue_guidance_est": "91170920.000",
      "revenue_guidance_max": "100000000.000",
      "revenue_guidance_min": "100000000.000",
      "revenue_guidance_prior_max": "100000000",
      "revenue_guidance_prior_min": "100000000.000",
      "revenue_type": "GAAP",
      "ticker": "RCT",
      "time": "09:30:00",
      "updated": 1767623735
    }
  ],
  "page": 0
}
```

### List insider filings

Find insider trades reported to the SEC on Form 4, with who traded, each transaction and the shares left, by ticker and date. Gets one page; to see more, run it again with the next page.

**Inputs**

- Tickers (`tickers`, text): Only these stocks: one or more ticker symbols separated by commas, such as AAPL, MSFT (up to 50). Leave empty for all.
- From date (`date_from`, date): Only records on or after this date.
- To date (`date_to`, date): Only records on or before this date.
- Changed since (`updated_since`, date and time): Only records added or changed at or after this time. Use it to pick up only what is new since an earlier run.
- Page (`page`, number): Which page to get, starting at 0. Benzinga returns at most 10,000 records in all for one search. At least 0.
- Page size (`page_size`, number): How many to return, 1 to 1,000. From 1 to 1000.

**Outputs**

- `count` (number): How many records this page holds
- `filings` (list): The filings
- `page` (number): The page returned, from 0

**Example output**

```json
{
  "count": 1,
  "filings": [
    {
      "accession_number": "0000905729-26-000009",
      "company_cik": "0000803164",
      "company_name": "CHOICEONE FINANCIAL SERVICES INC",
      "company_symbol": "COFS",
      "filing_date": "2026-01-05T19:54:05Z",
      "form_type": "4",
      "html_url": "https://www.sec.gov/Archives/edgar/data/803164/000090572926000009/0000905729-26-000009-index.htm",
      "id": "695c171b1bd4be0001967659",
      "is_10b5": false,
      "owner": {
        "insider_cik": "0001788991",
        "insider_name": "Gregory McConnell",
        "insider_title": "",
        "is_director": true,
        "is_officer": false,
        "is_ten_percent_owner": false
      },
      "remaining_shares": "34400",
      "traded_percentage": "0.68%",
      "transactions": [
        {
          "acquired_or_disposed": "A",
          "date_transaction": "2026-01-01T00:00:00Z",
          "is_derivative": false,
          "ownership": "d",
          "post_transaction_quantity": "34400",
          "price_per_share": "29.52",
          "security_title": "Common Stock",
          "shares": "233",
          "transaction_code": "a",
          "transaction_id": "0000803164_0000905729-26-000009_nd_t_0"
        }
      ],
      "updated": 1767642907
    }
  ],
  "page": 0
}
```

### List IPOs

Find initial public offerings with their price range, underwriters and deal status, by ticker or date. Gets one page; to see more, run it again with the next page.

**Inputs**

- Tickers (`tickers`, text): Only these stocks: one or more ticker symbols separated by commas, such as AAPL, MSFT (up to 50). Leave empty for all.
- IPO date (`ipo_date`, date): Only IPOs on this date.
- From date (`date_from`, date): Only records on or after this date.
- To date (`date_to`, date): Only records on or before this date.
- IPO type (`ipo_type`, text): Only IPOs of this type, as Benzinga names it, such as SPAC Unit.
- Changed since (`updated_since`, date and time): Only records added or changed at or after this time. Use it to pick up only what is new since an earlier run.
- Page (`page`, number): Which page to get, starting at 0. Benzinga returns at most 10,000 records in all for one search. At least 0.
- Page size (`page_size`, number): How many to return, 1 to 1,000. From 1 to 1000.

**Outputs**

- `count` (number): How many records this page holds
- `ipos` (list): The IPOs
- `page` (number): The page returned, from 0

**Example output**

```json
{
  "count": 1,
  "ipos": [
    {
      "currency": "USD",
      "date": "2026",
      "deal_status": "Withdrawn",
      "description": "",
      "exchange": "NASDAQ",
      "id": "604b6d8a36622a000186b793",
      "initial_filing_date": "",
      "insider_lockup_date": "",
      "insider_lockup_days": 180,
      "ipo_type": "SPAC Unit",
      "lead_underwriters": [
        "Citigroup"
      ],
      "market_cap_at_offer": 0,
      "name": "SEP Growth Holdings Corp",
      "notes": "",
      "offering_shares": 25000000,
      "offering_value": 0,
      "other_underwriters": [],
      "price_max": "",
      "price_min": "",
      "price_open": "",
      "price_public_offering": "10.000",
      "pricing_date": "",
      "sec_filing_url": "",
      "ticker": "SEPGU",
      "time": "08:32:58",
      "updated": 1767600431
    }
  ],
  "page": 0
}
```

### List mergers and acquisitions

Find mergers and acquisitions: who is buying whom, the deal size, terms and status, by ticker and date. Gets one page; to see more, run it again with the next page.

**Inputs**

- Tickers (`tickers`, text): Only these stocks: one or more ticker symbols separated by commas, such as AAPL, MSFT (up to 50). Leave empty for all.
- From date (`date_from`, date): Only records on or after this date.
- To date (`date_to`, date): Only records on or before this date.
- Date to sort by (`date_sort`, text): Which of the deal's dates to sort by. One of: `announced` (Announcement date), `expected` (Expected completion date), `completed` (Completion date).
- Minimum importance (`importance`, text): Only records Benzinga rates at least this important, from 0 (all) to 5. One of: `0` (0 or more (everything)), `1` (1 or more), `2` (2 or more), `3` (3 or more), `4` (4 or more), `5` (5 (most important only)).
- Changed since (`updated_since`, date and time): Only records added or changed at or after this time. Use it to pick up only what is new since an earlier run.
- Page (`page`, number): Which page to get, starting at 0. Benzinga returns at most 10,000 records in all for one search. At least 0.
- Page size (`page_size`, number): How many to return, 1 to 1,000. From 1 to 1000.

**Outputs**

- `count` (number): How many records this page holds
- `deals` (list): The deals
- `page` (number): The page returned, from 0

**Example output**

```json
{
  "count": 1,
  "deals": [
    {
      "acquirer_cusip": "233377407",
      "acquirer_exchange": "NASDAQ",
      "acquirer_isin": "US2333774071",
      "acquirer_name": "DXP Enterprises",
      "acquirer_ticker": "DXPE",
      "currency": "USD",
      "date": "2026-01-05",
      "date_completed": "2026-01-05",
      "date_expected": "",
      "deal_payment_type": "",
      "deal_size": "",
      "deal_status": "Completed",
      "deal_terms_extra": "Terms of the transaction are not being disclosed.",
      "deal_type": "Acquisition",
      "id": "695bc1b183cac20001bec44e",
      "importance": 2,
      "notes": "",
      "target_exchange": "",
      "target_name": "PREMIERflow, LLC",
      "target_ticker": "",
      "updated": 1767621689
    }
  ],
  "page": 0
}
```

### List news

Find Benzinga news stories by ticker, channel, topic, date or time published or changed, newest first. Gets one page; to see more, run it again with the next page.

**Inputs**

- Tickers (`tickers`, text): Only these stocks: one or more ticker symbols separated by commas, such as AAPL, MSFT (up to 50). Leave empty for all.
- Channels (`channels`, list): Only stories in these channels, such as Analyst Ratings, Earnings or Press Releases.
- Topics (`topics`, text): Words or phrases to search for in the headline, tags and story, separated by commas. Stories matching any of them are returned.
- From date (`date_from`, date): Only records on or after this date.
- To date (`date_to`, date): Only records on or before this date.
- Published since (`published_since`, date and time): Only stories first published at or after this time.
- Changed since (`updated_since`, date and time): Only records added or changed at or after this time. Use it to pick up only what is new since an earlier run.
- Story text (`display_output`, text): How much of each story to include. Defaults to the headline only. One of: `headline` (Headline only (default)), `abstract` (Headline and teaser), `full` (Headline and full story).
- Order (`sort`, text): How to order the stories. Defaults to newest published first. One of: `created:desc` (Newest published first (default)), `created:asc` (Oldest published first), `updated:desc` (Most recently updated first), `updated:asc` (Least recently updated first), `id:desc` (Highest id first), `id:asc` (Lowest id first).
- Page (`page`, number): Which page to get, starting at 0. Benzinga returns at most 10,000 records in all for one search. At least 0.
- Page size (`page_size`, number): How many to return, 1 to 100. Benzinga's default is 15. From 1 to 100.

**Outputs**

- `articles` (list): The news stories
- `count` (number): How many records this page holds
- `page` (number): The page returned, from 0

**Example output**

```json
{
  "articles": [
    {
      "author": "Benzinga Insights",
      "body": "",
      "channels": [
        {
          "name": "Options"
        }
      ],
      "created": "Mon, 01 Jan 2024 13:35:14 -0400",
      "id": 36444586,
      "image": [
        {
          "alt": "Applied optoelectronics website",
          "size": "thumb",
          "url": "https://cdn.benzinga.com/files/imagecache/250x187xUP/images/story/2023/options_image_2.jpeg"
        }
      ],
      "stocks": [
        {
          "cusip": "037833100",
          "exchange": "NASDAQ",
          "isin": "US0378331005",
          "name": "AAPL"
        }
      ],
      "tags": [
        {
          "name": "BZI-AUOA"
        }
      ],
      "teaser": "",
      "title": "10 Information Technology Stocks With Whale Alerts In Today's Session",
      "updated": "Mon, 01 Jan 2024 13:35:15 -0400",
      "url": "https://www.benzinga.com/markets/options/24/01/36444586/10-information-technology-stocks-with-whale-alerts-in-todays-session"
    }
  ],
  "count": 1,
  "page": 0
}
```

### List news channels

List every channel Benzinga files news under, to filter stories by.

**Inputs**: None.

**Outputs**

- `channels` (list): The channels
- `count` (number): How many

**Example output**

```json
{
  "channels": [
    {
      "id": "",
      "name": "Analyst Ratings"
    },
    {
      "id": "",
      "name": "WIIM"
    }
  ],
  "count": 2
}
```

### List rating firms

List the research firms whose analyst ratings Benzinga tracks. Gets one page; to see more, run it again with the next page.

**Inputs**

- Page (`page`, number): Which page to get, starting at 0. Benzinga returns at most 10,000 records in all for one search. At least 0.
- Page size (`page_size`, number): How many to return, 1 to 1,000. From 1 to 1000.

**Outputs**

- `count` (number): How many records this page holds
- `firms` (list): The firms
- `page` (number): The page returned, from 0

**Example output**

```json
{
  "count": 1,
  "firms": [
    {
      "id": "57f832a96b87f600016fa347",
      "name": "Morgan Stanley"
    }
  ],
  "page": 0
}
```

### List removed news

List the ids of stories Benzinga has taken down, with when, so copies you keep can be removed too. Gets one page; to see more, run it again with the next page.

**Inputs**

- Changed since (`updated_since`, date and time): Only records added or changed at or after this time. Use it to pick up only what is new since an earlier run.
- Page (`page`, number): Which page to get, starting at 0. Benzinga returns at most 10,000 records in all for one search. At least 0.
- Page size (`page_size`, number): How many to return, 1 to 1,000. Benzinga's default is 100. From 1 to 1000.

**Outputs**

- `count` (number): How many records this page holds
- `page` (number): The page returned, from 0
- `removed` (list): The removed stories

**Example output**

```json
{
  "count": 1,
  "page": 0,
  "removed": [
    {
      "id": 123456,
      "updated": "Wed, 17 May 2017 14:20:15 -0400"
    }
  ]
}
```

### List secondary offerings

Find secondary offerings, listed companies selling more shares, with price and proceeds, by ticker and date. Gets one page; to see more, run it again with the next page.

**Inputs**

- Tickers (`tickers`, text): Only these stocks: one or more ticker symbols separated by commas, such as AAPL, MSFT (up to 50). Leave empty for all.
- From date (`date_from`, date): Only records on or after this date.
- To date (`date_to`, date): Only records on or before this date.
- Minimum importance (`importance`, text): Only records Benzinga rates at least this important, from 0 (all) to 5. One of: `0` (0 or more (everything)), `1` (1 or more), `2` (2 or more), `3` (3 or more), `4` (4 or more), `5` (5 (most important only)).
- Changed since (`updated_since`, date and time): Only records added or changed at or after this time. Use it to pick up only what is new since an earlier run.
- Page (`page`, number): Which page to get, starting at 0. Benzinga returns at most 10,000 records in all for one search. At least 0.
- Page size (`page_size`, number): How many to return, 1 to 1,000. From 1 to 1000.

**Outputs**

- `count` (number): How many records this page holds
- `offerings` (list): The offerings
- `page` (number): The page returned, from 0

**Example output**

```json
{
  "count": 1,
  "offerings": [
    {
      "currency": "USD",
      "cusip": "73245B107",
      "date": "2025-12-29",
      "dollar_shares": "50000000.000",
      "exchange": "NASDAQ",
      "id": "69531bc06ab0a40001b39686",
      "importance": 2,
      "name": "SBC Medical Group Holding",
      "notes": "",
      "number_shares": 0,
      "offering_type": "",
      "price": "",
      "proceeds": "",
      "shelf": true,
      "ticker": "SBC",
      "time": "19:24:32",
      "updated": 1767054276,
      "url": ""
    }
  ],
  "page": 0
}
```

### List stock splits

Find stock splits with their ratio and dates, by ticker and date. Gets one page; to see more, run it again with the next page.

**Inputs**

- Tickers (`tickers`, text): Only these stocks: one or more ticker symbols separated by commas, such as AAPL, MSFT (up to 50). Leave empty for all.
- From date (`date_from`, date): Only records on or after this date.
- To date (`date_to`, date): Only records on or before this date.
- Date to filter by (`date_field`, text): Which date the date range applies to. Defaults to the announcement. One of: `announced` (Announcement date (default)), `ex` (Ex-date).
- Minimum importance (`importance`, text): Only records Benzinga rates at least this important, from 0 (all) to 5. One of: `0` (0 or more (everything)), `1` (1 or more), `2` (2 or more), `3` (3 or more), `4` (4 or more), `5` (5 (most important only)).
- Changed since (`updated_since`, date and time): Only records added or changed at or after this time. Use it to pick up only what is new since an earlier run.
- Page (`page`, number): Which page to get, starting at 0. Benzinga returns at most 10,000 records in all for one search. At least 0.
- Page size (`page_size`, number): How many to return, 1 to 1,000. From 1 to 1000.

**Outputs**

- `count` (number): How many records this page holds
- `page` (number): The page returned, from 0
- `splits` (list): The splits

**Example output**

```json
{
  "count": 1,
  "page": 0,
  "splits": [
    {
      "cusip": "87807D509",
      "date_announced": "2025-12-30",
      "date_distribution": "2025-01-06",
      "date_ex": "2025-01-07",
      "date_recorded": "2025-01-02",
      "exchange": "NASDAQ",
      "id": "677675329a903000017cb6f1",
      "importance": 1,
      "name": "TC BioPharm (Holdings)",
      "notes": "",
      "optionable": false,
      "ratio": "1.25:1",
      "split_type": "ADR Ratio Change",
      "ticker": "TCBP",
      "updated": 1735816783
    }
  ]
}
```

### List unusual options activity

Find large or unusual options trades, with whether each looks bullish or bearish, by ticker and date. Gets one page; to see more, run it again with the next page.

**Inputs**

- Tickers (`tickers`, text): Only these stocks: one or more ticker symbols separated by commas, such as AAPL, MSFT (up to 50). Leave empty for all.
- From date (`date_from`, date): Only records on or after this date.
- To date (`date_to`, date): Only records on or before this date.
- Changed since (`updated_since`, date and time): Only records added or changed at or after this time. Use it to pick up only what is new since an earlier run.
- Page (`page`, number): Which page to get, starting at 0. Benzinga returns at most 10,000 records in all for one search. At least 0.
- Page size (`page_size`, number): How many to return, 1 to 1,000. From 1 to 1000.

**Outputs**

- `count` (number): How many records this page holds
- `option_activity` (list): The options trades
- `page` (number): The page returned, from 0

**Example output**

```json
{
  "count": 1,
  "option_activity": [
    {
      "aggressor_ind": "0.73",
      "ask": "5.75",
      "bid": "5.2",
      "cost_basis": "336000.0",
      "date": "2025-12-29",
      "date_expiration": "2026-09-18",
      "description": "Freeport-McMoRan Option Alert: Sep 18 $50 Puts at the Ask: 600 vs 636 OI",
      "description_extended": "Freeport-McMoRan Option Alert: Sep 18 $50 Puts at the Ask: 600 @ $5.6 vs 636 OI; Ref=$51.4",
      "exchange": "NYSE",
      "execution_estimate": "AT_ASK",
      "id": "6952ef7b6ab0a40001b39586",
      "midpoint": "5.475",
      "open_interest": "636",
      "option_activity_type": "TRADE",
      "option_symbol": "FCX260918P00050000",
      "price": "5.6",
      "put_call": "PUT",
      "sentiment": "BEARISH",
      "size": "600",
      "strike_price": "50.00",
      "ticker": "FCX",
      "time": "16:15:32",
      "trade_count": 1,
      "underlying_price": "51.4",
      "underlying_type": "STOCK",
      "updated": 1767042939,
      "volume": "1601"
    }
  ],
  "page": 0
}
```

### List Why Is It Moving stories

Find Benzinga's Why Is It Moving stories, which explain why a stock's price moved, by ticker and date. Gets one page; to see more, run it again with the next page.

**Inputs**

- Tickers (`tickers`, text): Only these stocks: one or more ticker symbols separated by commas, such as AAPL, MSFT (up to 50). Leave empty for all.
- From date (`date_from`, date): Only records on or after this date.
- To date (`date_to`, date): Only records on or before this date.
- Changed since (`updated_since`, date and time): Only records added or changed at or after this time. Use it to pick up only what is new since an earlier run.
- Story text (`display_output`, text): How much of each story to include. Defaults to the headline only. One of: `headline` (Headline only (default)), `abstract` (Headline and teaser), `full` (Headline and full story).
- Page (`page`, number): Which page to get, starting at 0. Benzinga returns at most 10,000 records in all for one search. At least 0.
- Page size (`page_size`, number): How many to return, 1 to 100. Benzinga's default is 15. From 1 to 100.

**Outputs**

- `articles` (list): The stories
- `count` (number): How many records this page holds
- `page` (number): The page returned, from 0

**Example output**

```json
{
  "articles": [
    {
      "author": "Benzinga Insights",
      "body": "",
      "channels": [
        {
          "name": "WIIM"
        }
      ],
      "created": "Mon, 01 Jan 2024 13:35:14 -0400",
      "id": 36444600,
      "image": [
        {
          "alt": "Applied optoelectronics website",
          "size": "thumb",
          "url": "https://cdn.benzinga.com/files/imagecache/250x187xUP/images/story/2023/options_image_2.jpeg"
        }
      ],
      "stocks": [
        {
          "cusip": "037833100",
          "exchange": "NASDAQ",
          "isin": "US0378331005",
          "name": "AAPL"
        }
      ],
      "tags": [
        {
          "name": "BZI-AUOA"
        }
      ],
      "teaser": "",
      "title": "Why Apple Shares Are Trading Higher Today",
      "updated": "Mon, 01 Jan 2024 13:35:15 -0400",
      "url": "https://www.benzinga.com/news/24/01/36444600/why-apple-shares-are-trading-higher-today"
    }
  ],
  "count": 1,
  "page": 0
}
```
