Bulls Say / Bears Say API Reference

Free Trial ➡

Empower users to “see both sides of the story” before investing. We simplify investment research for all, whether you’re a seasoned investor or just starting out, this product will simplify your investment decisions by distilling complex analyst reports into actionable insights. This API provides concise summaries of analyst reports, presenting both bullish and bearish arguments for a stock. Say goodbye to jargon-filled reports and hello to clear, insightful information. We analyze the details so you don’t have to. The “Bulls Say” summary highlights positive aspects, while the “Bears Say” summary points out potential risks.

API Endpoint

https://api.benzinga.com/api/v1

Schemes

https, http

Version

1.0

Authentication

`token` authentication

Type:: apiKey
Name:: token
In:: query

Playground

Endpoints

GET /bulls_bears_say

Get the bulls and the bears responses.

Parameters

Name	Type	Location	Description
`accept`	string , x ∈ { application/json (default) , application/xml (deprecated) }	header	Specify return format.
`symbols`	string (csv)	query	One or more comma separated symbols to specify companies to get data for.
`latest`	boolean (true or false)	query	Return the latest Bulls Say or Bears Say response for a particular company.
`pagesize`	string	query	The number of items in the response (limit is 100 items per page).

Responses

Code	Model	Description
`200 OK`	bulls_bears_sayResponse	Successful response

Response (200 OK)

[
  {
    "analyst_firms_referenced": "integer",
    "bear_case": "string",
    "bull_case": "string"
  }
]

Models

bulls_bears_sayResponse: object

Property	Type	Description
`analyst_firms_referenced`	integer	The number of sell side analyst reports referenced in case.
`bear_case`	string	The bearish case.
`bull_case`	string	The bullish case.
`bull_case[].bull_case`	string (float)	The bullish case.
`bull_case[].bear_case`	number (float)	The bearish case.
`bull_case[].ticker`	number (float)	The security being mentioned in the bull and bear cases.
`bull_case[].updated`	number (float)	The updated unix timestamp of the output.

Structure (JSON)

{
  "analyst_firms_referenced": "integer",
  "bear_case": "string",
  "bull_case": "string"
}

Documentation