Polygon Benzinga API

The benzinga API from Polygon — 9 operation(s) for benzinga.

Operations 9

GET /benzinga/v1/analyst-insights #
GET /benzinga/v1/analysts #
GET /benzinga/v1/bulls-bears-say #
GET /benzinga/v1/consensus-ratings/{ticker} #
GET /benzinga/v1/earnings #
GET /benzinga/v1/firms #
GET /benzinga/v1/guidance #
GET /benzinga/v1/ratings #
GET /benzinga/v2/news #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/polygon-benzinga-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

polygon-benzinga-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  description: The future of fintech.
  title: Polygon Benzinga API
  version: 1.0.0
servers:
- description: Polygon Platform API
  url: https://api.polygon.io
- description: Polygon Platform API (Staging)
  url: https://api.staging.polygon.io
security:
- apiKey: []
tags:
- name: benzinga
paths:
  /benzinga/v1/analyst-insights:
    get:
      description: A comprehensive database of financial analyst insights and ratings for various publicly traded companies, capturing detailed information about analyst recommendations and price targets.
      operationId: get_benzinga_v1_analyst-insights
      parameters:
      - description: The calendar date (formatted as YYYY-MM-DD) when the rating was issued.
        in: query
        name: date
        schema:
          type: string
      - description: Filter equal to any of the values. Multiple values can be specified by using a comma separated list.
        in: query
        name: date.any_of
        schema:
          type: string
      - description: Filter greater than the value.
        in: query
        name: date.gt
        schema:
          type: string
      - description: Filter greater than or equal to the value.
        in: query
        name: date.gte
        schema:
          type: string
      - description: Filter less than the value.
        in: query
        name: date.lt
        schema:
          type: string
      - description: Filter less than or equal to the value.
        in: query
        name: date.lte
        schema:
          type: string
      - description: The stock symbol of the company being rated.
        in: query
        name: ticker
        schema:
          type: string
      - description: Filter equal to any of the values. Multiple values can be specified by using a comma separated list.
        in: query
        name: ticker.any_of
        schema:
          type: string
      - description: Filter greater than the value.
        in: query
        name: ticker.gt
        schema:
          type: string
      - description: Filter greater than or equal to the value.
        in: query
        name: ticker.gte
        schema:
          type: string
      - description: Filter less than the value.
        in: query
        name: ticker.lt
        schema:
          type: string
      - description: Filter less than or equal to the value.
        in: query
        name: ticker.lte
        schema:
          type: string
      - description: The timestamp (formatted as an ISO 8601 timestamp) when the rating was last updated in the system. Value must be an integer timestamp in seconds, formatted 'yyyy-mm-dd', or ISO 8601/RFC 3339 (e.g. '2024-05-28T20:27:41Z').
        in: query
        name: last_updated
        schema:
          type: string
      - description: Filter greater than the value. Value must be an integer timestamp in seconds, formatted 'yyyy-mm-dd', or ISO 8601/RFC 3339 (e.g. '2024-05-28T20:27:41Z').
        in: query
        name: last_updated.gt
        schema:
          type: string
      - description: Filter greater than or equal to the value. Value must be an integer timestamp in seconds, formatted 'yyyy-mm-dd', or ISO 8601/RFC 3339 (e.g. '2024-05-28T20:27:41Z').
        in: query
        name: last_updated.gte
        schema:
          type: string
      - description: Filter less than the value. Value must be an integer timestamp in seconds, formatted 'yyyy-mm-dd', or ISO 8601/RFC 3339 (e.g. '2024-05-28T20:27:41Z').
        in: query
        name: last_updated.lt
        schema:
          type: string
      - description: Filter less than or equal to the value. Value must be an integer timestamp in seconds, formatted 'yyyy-mm-dd', or ISO 8601/RFC 3339 (e.g. '2024-05-28T20:27:41Z').
        in: query
        name: last_updated.lte
        schema:
          type: string
      - description: The name of the research firm or investment bank issuing the rating.
        in: query
        name: firm
        schema:
          type: string
      - description: Filter equal to any of the values. Multiple values can be specified by using a comma separated list.
        in: query
        name: firm.any_of
        schema:
          type: string
      - description: Filter greater than the value.
        in: query
        name: firm.gt
        schema:
          type: string
      - description: Filter greater than or equal to the value.
        in: query
        name: firm.gte
        schema:
          type: string
      - description: Filter less than the value.
        in: query
        name: firm.lt
        schema:
          type: string
      - description: Filter less than or equal to the value.
        in: query
        name: firm.lte
        schema:
          type: string
      - description: 'The description of the change in rating from the firm''s last rating. Possible values include: downgrades, maintains, reinstates, reiterates, upgrades, assumes, initiates_coverage_on, terminates_coverage_on, removes, suspends, firm_dissolved.'
        in: query
        name: rating_action
        schema:
          type: string
      - description: Filter equal to any of the values. Multiple values can be specified by using a comma separated list.
        in: query
        name: rating_action.any_of
        schema:
          type: string
      - description: Filter greater than the value.
        in: query
        name: rating_action.gt
        schema:
          type: string
      - description: Filter greater than or equal to the value.
        in: query
        name: rating_action.gte
        schema:
          type: string
      - description: Filter less than the value.
        in: query
        name: rating_action.lt
        schema:
          type: string
      - description: Filter less than or equal to the value.
        in: query
        name: rating_action.lte
        schema:
          type: string
      - description: The identifier used by Benzinga for the firm record.
        in: query
        name: benzinga_firm_id
        schema:
          type: string
      - description: Filter equal to any of the values. Multiple values can be specified by using a comma separated list.
        in: query
        name: benzinga_firm_id.any_of
        schema:
          type: string
      - description: Filter greater than the value.
        in: query
        name: benzinga_firm_id.gt
        schema:
          type: string
      - description: Filter greater than or equal to the value.
        in: query
        name: benzinga_firm_id.gte
        schema:
          type: string
      - description: Filter less than the value.
        in: query
        name: benzinga_firm_id.lt
        schema:
          type: string
      - description: Filter less than or equal to the value.
        in: query
        name: benzinga_firm_id.lte
        schema:
          type: string
      - description: The identifier used by Benzinga for the rating record.
        in: query
        name: benzinga_rating_id
        schema:
          type: string
      - description: Filter equal to any of the values. Multiple values can be specified by using a comma separated list.
        in: query
        name: benzinga_rating_id.any_of
        schema:
          type: string
      - description: Filter greater than the value.
        in: query
        name: benzinga_rating_id.gt
        schema:
          type: string
      - description: Filter greater than or equal to the value.
        in: query
        name: benzinga_rating_id.gte
        schema:
          type: string
      - description: Filter less than the value.
        in: query
        name: benzinga_rating_id.lt
        schema:
          type: string
      - description: Filter less than or equal to the value.
        in: query
        name: benzinga_rating_id.lte
        schema:
          type: string
      - description: Limit the maximum number of results returned. Defaults to '100' if not specified. The maximum allowed limit is '50000'.
        in: query
        name: limit
        schema:
          default: 100
          maximum: 50000
          minimum: 1
          type: integer
      - description: A comma separated list of sort columns. For each column, append '.asc' or '.desc' to specify the sort direction. The sort column defaults to 'last_updated' if not specified. The sort order defaults to 'desc' if not specified.
        in: query
        name: sort
        schema:
          default: last_updated.desc
          type: string
      responses:
        '200':
          content:
            application/json:
              example:
                count: 1
                request_id: 1
                results:
                - benzinga_firm_id: 606af0aa6538960001bced21
                  benzinga_id: 681363c1fd0258abcbedc074
                  benzinga_rating_id: 6813624c09c1f6000103ac25
                  date: '2025-05-01'
                  firm: Needham
                  insight: "Needham maintained their Buy rating on Etsy's stock with a price target of $55.00.  \n\n **Growth Initiatives and Market Penetration**: Etsy's focus on growth initiatives, including leveraging its app for a more personalized shopping experience and marketing, has been a key factor in maintaining its Buy rating. The company's ability to drive greater consideration and purchase frequency through technology and product initiatives, alongside its significant app penetration of gross merchandise sales (GMS), showcases its strong position to capture more of the consumer wallet.\n\n**Resilience Amid Economic Uncertainty**: Despite the economic uncertainty, including potential impacts from tariffs, Etsy's asset-light model and strategic focus on product enhancements position it to navigate macro headwinds effectively. The company's efforts to lean into paid social channels for marketing and its ability to adapt to changes in consumer behavior underline its resilience and potential for sustained growth, supporting the Buy rating."
                  last_updated: '2025-05-01T12:06:36Z'
                  price_target: 55
                  rating: buy
                  rating_action: maintains
                status: OK
              schema:
                properties:
                  next_url:
                    description: If present, this value can be used to fetch the next page.
                    type: string
                  request_id:
                    description: A request id assigned by the server.
                    type: string
                  results:
                    description: The results for this request.
                    items:
                      properties:
                        benzinga_firm_id:
                          description: The identifier used by Benzinga for the firm record.
                          type: string
                        benzinga_id:
                          description: The identifier used by Benzinga for this record.
                          type: string
                        benzinga_rating_id:
                          description: The identifier used by Benzinga for the rating record.
                          type: string
                        company_name:
                          description: The name of the company being rated.
                          type: string
                        date:
                          description: The calendar date (formatted as YYYY-MM-DD) when the rating was issued.
                          type: string
                        firm:
                          description: The name of the research firm or investment bank issuing the rating.
                          type: string
                        insight:
                          description: Narrative commentary or reasoning provided by the analyst or firm to explain the rating or price target.
                          type: string
                        last_updated:
                          description: The timestamp (formatted as an ISO 8601 timestamp) when the rating was last updated in the system.
                          format: date-time
                          type: string
                        price_target:
                          description: The current price target set by the analyst.
                          format: double
                          type: number
                        rating:
                          description: The current rating set by the analyst.
                          type: string
                        rating_action:
                          description: 'The description of the change in rating from the firm''s last rating. Possible values include: downgrades, maintains, reinstates, reiterates, upgrades, assumes, initiates_coverage_on, terminates_coverage_on, removes, suspends, firm_dissolved.'
                          type: string
                        ticker:
                          description: The stock symbol of the company being rated.
                          type: string
                      type: object
                    type: array
                  status:
                    description: The status of this request's response.
                    enum:
                    - OK
                    type: string
                required:
                - status
                - request_id
                - results
                type: object
          description: A list of results.
        '400':
          content:
            application/json:
              schema:
                properties:
                  error:
                    description: A message describing the source of the error.
                    type: string
                  request_id:
                    description: A request id assigned by the server.
                    type: string
                  status:
                    description: The status of this request's response.
                    enum:
                    - ERROR
                    type: string
                required:
                - status
                - request_id
                - error
                type: object
          description: An error message.
      tags:
      - benzinga
  /benzinga/v1/analysts:
    get:
      description: A comprehensive database of financial analysts, containing detailed performance metrics and identification information for individual analysts across various financial firms.
      operationId: get_benzinga_v1_analysts
      parameters:
      - description: The identifier used by Benzinga for this record.
        in: query
        name: benzinga_id
        schema:
          type: string
      - description: Filter equal to any of the values. Multiple values can be specified by using a comma separated list.
        in: query
        name: benzinga_id.any_of
        schema:
          type: string
      - description: Filter greater than the value.
        in: query
        name: benzinga_id.gt
        schema:
          type: string
      - description: Filter greater than or equal to the value.
        in: query
        name: benzinga_id.gte
        schema:
          type: string
      - description: Filter less than the value.
        in: query
        name: benzinga_id.lt
        schema:
          type: string
      - description: Filter less than or equal to the value.
        in: query
        name: benzinga_id.lte
        schema:
          type: string
      - description: The unique identifier assigned by Benzinga to the research firm or investment bank.
        in: query
        name: benzinga_firm_id
        schema:
          type: string
      - description: Filter equal to any of the values. Multiple values can be specified by using a comma separated list.
        in: query
        name: benzinga_firm_id.any_of
        schema:
          type: string
      - description: Filter greater than the value.
        in: query
        name: benzinga_firm_id.gt
        schema:
          type: string
      - description: Filter greater than or equal to the value.
        in: query
        name: benzinga_firm_id.gte
        schema:
          type: string
      - description: Filter less than the value.
        in: query
        name: benzinga_firm_id.lt
        schema:
          type: string
      - description: Filter less than or equal to the value.
        in: query
        name: benzinga_firm_id.lte
        schema:
          type: string
      - description: The name of the research firm or investment bank issuing the ratings.
        in: query
        name: firm_name
        schema:
          type: string
      - description: Filter equal to any of the values. Multiple values can be specified by using a comma separated list.
        in: query
        name: firm_name.any_of
        schema:
          type: string
      - description: Filter greater than the value.
        in: query
        name: firm_name.gt
        schema:
          type: string
      - description: Filter greater than or equal to the value.
        in: query
        name: firm_name.gte
        schema:
          type: string
      - description: Filter less than the value.
        in: query
        name: firm_name.lt
        schema:
          type: string
      - description: Filter less than or equal to the value.
        in: query
        name: firm_name.lte
        schema:
          type: string
      - description: The full name of the analyst associated with the ratings.
        in: query
        name: full_name
        schema:
          type: string
      - description: Filter equal to any of the values. Multiple values can be specified by using a comma separated list.
        in: query
        name: full_name.any_of
        schema:
          type: string
      - description: Filter greater than the value.
        in: query
        name: full_name.gt
        schema:
          type: string
      - description: Filter greater than or equal to the value.
        in: query
        name: full_name.gte
        schema:
          type: string
      - description: Filter less than the value.
        in: query
        name: full_name.lt
        schema:
          type: string
      - description: Filter less than or equal to the value.
        in: query
        name: full_name.lte
        schema:
          type: string
      - description: Limit the maximum number of results returned. Defaults to '100' if not specified. The maximum allowed limit is '50000'.
        in: query
        name: limit
        schema:
          default: 100
          maximum: 50000
          minimum: 1
          type: integer
      - description: A comma separated list of sort columns. For each column, append '.asc' or '.desc' to specify the sort direction. The sort column defaults to 'full_name' if not specified. The sort order defaults to 'asc' if not specified.
        in: query
        name: sort
        schema:
          default: full_name.asc
          type: string
      responses:
        '200':
          content:
            application/json:
              example:
                count: 1
                request_id: 1
                results:
                - benzinga_firm_id: 5e17143f7da4190001b2eaa6
                  benzinga_id: 65eb18289b25ca0001b34332
                  firm_name: B of A Securities
                  full_name: Alice Xiao
                  last_updated: '2025-05-19T04:31:12Z'
                  overall_avg_return: 12.48
                  overall_avg_return_percentile: 66.53
                  overall_success_rate: 100
                  smart_score: 67.94
                  total_ratings: 4
                  total_ratings_percentile: 32.17
                status: OK
              schema:
                properties:
                  next_url:
                    description: If present, this value can be used to fetch the next page.
                    type: string
                  request_id:
                    description: A request id assigned by the server.
                    type: string
                  results:
                    description: The results for this request.
                    items:
                      properties:
                        benzinga_firm_id:
                          description: The unique identifier assigned by Benzinga to the research firm or investment bank.
                          type: string
                        benzinga_id:
                          description: The identifier used by Benzinga for this record.
                          type: string
                        firm_name:
                          description: The name of the research firm or investment bank issuing the ratings.
                          type: string
                        full_name:
                          description: The full name of the analyst associated with the ratings.
                          type: string
                        last_updated:
                          description: The timestamp (formatted as an ISO 8601 timestamp) when the analyst record was last updated in the system.
                          type: string
                        overall_avg_return:
                          description: The average percent price difference per rating since the date of recommendation.
                          format: double
                          type: number
                        overall_avg_return_percentile:
                          description: The analyst's percentile rank based on average return, relative to other analysts.
                          format: double
                          type: number
                        overall_success_rate:
                          description: The percentage of gain/loss ratings that resulted in a gain overall.
                          format: double
                          type: number
                        smart_score:
                          description: A weighted average of the total_ratings_percentile, overall_avg_return_percentile, and overall_success_rate.
                          format: double
                          type: number
                        total_ratings:
                          description: The total number of ratings issued by the analyst included in the performance calculation.
                          format: double
                          type: number
                        total_ratings_percentile:
                          description: The analyst's percentile rank based on the total number of ratings issued, relative to other analysts.
                          format: double
                          type: number
                      type: object
                    type: array
                  status:
                    description: The status of this request's response.
                    enum:
                    - OK
                    type: string
                required:
                - status
                - request_id
                - results
                type: object
          description: A list of results.
        '400':
          content:
            application/json:
              schema:
                properties:
                  error:
                    description: A message describing the source of the error.
                    type: string
                  request_id:
                    description: A request id assigned by the server.
                    type: string
                  status:
                    description: The status of this request's response.
                    enum:
                    - ERROR
                    type: string
                required:
                - status
                - request_id
                - error
                type: object
          description: An error message.
      tags:
      - benzinga
  /benzinga/v1/bulls-bears-say:
    get:
      description: A comprehensive database of analyst bull and bear case summaries for publicly traded companies, providing concise summaries of both bullish and bearish investment arguments to help investors see both sides of the story before making investment decisions.
      operationId: get_benzinga_v1_bulls-bears-say
      parameters:
      - description: The stock ticker symbol for the company associated with the bull and bear case summaries.
        in: query
        name: ticker
        schema:
          type: string
      - description: Filter equal to any of the values. Multiple values can be specified by using a comma separated list.
        in: query
        name: ticker.any_of
        schema:
          type: string
      - description: Filter greater than the value.
        in: query
        name: ticker.gt
        schema:
          type: string
      - description: Filter greater than or equal to the value.
        in: query
        name: ticker.gte
        schema:
          type: string
      - description: Filter less than the value.
        in: query
        name: ticker.lt
        schema:
          type: string
      - description: Filter less than or equal to the value.
        in: query
        name: ticker.lte
        schema:
          type: string
      - description: The unique identifier used by Benzinga for this bull/bear case record.
        in: query
        name: benzinga_id
        schema:
          type: string
      - description: Filter equal to any of the values. Multiple values can be specified by using a comma separated list.
        in: query
        name: benzinga_id.any_of
        schema:
          type: string
      - description: Filter greater than the value.
        in: query
        name: benzinga_id.gt
        schema:
          type: string
      - description: Filter greater than or equal to the value.
        in: query
        name: benzinga_id.gte
        schema:
          type: string
      - description: Filter less than the value.
        in: query
        name: benzinga_id.lt
        schema:
          type: string
      - description: Filter less than or equal to the value.
        in: query
        name: benzinga_id.lte
        schema:
          type: string
      - description: The timestamp (formatted as an ISO 8601 timestamp) when the bull/bear case was last updated in the system. Value must be an integer timestamp in seconds, formatted 'yyyy-mm-dd', or ISO 8601/RFC 3339 (e.g. '2024-05-28T20:27:41Z').
        in: query
        name: last_updated
        schema:
          type: string
      - description: Filter greater than the value. Value must be an integer timestamp in seconds, formatted 'yyyy-mm-dd', or ISO 8601/RFC 3339 (e.g. '2024-05-28T20:27:41Z').
        in: query
        name: last_updated.gt
        schema:
          type: string
      - description: Filter greater than or equal to the value. Value must be an integer timestamp in seconds, formatted 'yyyy-mm-dd', or ISO 8601/RFC 3339 (e.g. '2024-05-28T20:27:41Z').
        in: query
        name: last_updated.gte
        schema:
          type: string
      - description: Filter less than the value. Value must be an integer timestamp in seconds, formatted 'yyyy-mm-dd', or ISO 8601/RFC 3339 (e.g. '2024-05-28T20:27:41Z').
        in: query
        name: last_updated.lt
        schema:
          type: string
      - description: Filter less than or equal to the value. Value must be an integer timestamp in seconds, formatted 'yyyy-mm-dd', or ISO 8601/RFC 3339 (e.g. '2024-05-28T20:27:41Z').
        in: query
        name: last_updated.lte
        schema:
          type: string
      - description: Limit the maximum number of results returned. Defaults to '100' if not specified. The maximum allowed limit is '5000'.
        in: query
        name: limit
        schema:
          default: 100
          maximum: 5000
          minimum: 1
          type: integer
      - description: A comma separated list of sort columns. For each column, append '.asc' or '.desc' to specify the sort direction. The sort column defaults to 'ticker' if not specified. The sort order defaults to 'desc' if not specified.
        in: query
        name: sort
        schema:
          default: ticker.desc
          type: string
      responses:
        '200':
          content:
            application/json:
              example:
                count: 1
                request_id: 1
                results:
                - bear_case: Apple faces increasing regulatory scrutiny globally, potential market saturation in core iPhone markets, and intense competition in emerging categories. Supply chain vulnerabilities and dependence on China for manufacturing pose significant risks, while slowing innovation cycles could impact premium pricing.
                  benzinga_id: 550e8400-e29b-41d4-a716-446655440000
                  bull_case: Apple's strong ecosystem integration, loyal customer base, and continued innovation in services and hardware drive sustainable revenue growth. The company's expanding services segment provides high-margin recurring revenue, while its brand strength and pricing power maintain premium market positioning.
                  last_updated: '2025-12-16T10:30:00Z'
                  ticker: AAPL
                status: OK
              schema:
                properties:
                  next_url:
                    description: If present, this value can be used to fetch the next page.
                    type: string
                  request_id:
                    description: A request id assigned by the server.
                    type: string
                  results:
                    description: The results for this request.
                    items:
                      properties:
                        bear_case:
                          description: A concise summary of the bearish investment thesis, highlighting potential risks, challenges, and reasons why the stock could decline in value.
                          type: string
                        benzinga_id:
                          description: The unique identifier used by Benzinga for this bull/bear case record.
                          type: string
                        bull_case:
                          description: A concise summary of the bullish investment thesis, highlighting positive aspects, growth opportunities, and reasons why the stock could appreciate in value.
                          type: string
                        last_updated:
                          description: The timestamp (formatted as an ISO 8601 timestamp) when the bull/bear case was last updated in the system.
                          format: date-time
                          type: string
                        ticker:
                          description: The stock ticker symbol for the company associated with the bull and bear case summaries.
                          type: string
                      type: object
                    type: array
                  status:
                    description: The status of this request's response.
                    enum:
                    - OK
                    type: string
                required:
                - status
                - request_id
                - results
                type: object
          description: A list of results.
        '400':
          content:
            application/json:
              schema:
                properties:
                  error:
                    description: A message describing the source of the error.
                    type: string
                  request_id:
                    description: A request id assigned by the server.
                    type: string
                  status:
                    description: The status of this request's response.
                    enum:
                    - ERROR
                    type: string
                required:
                - status
                - request_id
                - error
                type: object
          description: An error message.
      tags:
      - benzinga
  /benzinga/v1/consensus-ratings/{ticker}:
    get:
      description: A comprehensive financial consensus ratings table that aggregates analyst recommendations and price targets for individual stock tickers, capturing detailed rating breakdowns and statistical insights.
      operationId: get_benzinga_v1_consensus-ratings_ticker
      parameters:
      - description: The date range to aggregate analyst ratings over. For example, date.gte=2024-10-01 and date.lt=2025-01-01 for ratings published in Q4 2024. By default, all ratings are aggregated regardless of date.
        in: query
        name: date
        schema:
          type: string

# --- truncated at 32 KB (117 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/polygon/refs/heads/main/openapi/polygon-benzinga-api-openapi.yml