Polygon Benzinga API
The benzinga API from Polygon — 9 operation(s) for benzinga.
The benzinga API from Polygon — 9 operation(s) for benzinga.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/polygon-benzinga-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
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: 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