Analyst Rating

GET https://api.unusualwhales.com/api/screener/analysts

Request

Security: Bearer Auth Authorization: Bearer <token>

Query Parameters

ticker SingleTicker optional

A single ticker

Example: AAPL

limit integer optional

How many items to return. Default: 500, Max: 500, Min: 1

action Analyst Action optional

The action of the recommendation.

Example: maintained

enum: initiated, reiterated, downgraded, upgraded, maintained

recommendation Analyst Recommendation optional

The recommendation the analyst gave out.

Example: hold

enum: buy, hold, sell

newer_than NewerThan optional

The unix time in milliseconds or seconds at which no older results will be returned. Can be used with `older_than` to paginate by time. Also accepts an ISO date or RFC 3339 datetime (example: 2024-01-25).

Example: 1_715_083_417

older_than OlderThan optional

The unix time in milliseconds or seconds at which no newer results will be returned. Can be used with `newer_than` to paginate by time. Also accepts an ISO date or RFC 3339 datetime (example: 2024-01-25).

Example: 1_715_083_417

Responses

200 422 500

Response Body 200 OK

action Analyst Field Action

The action of the recommendation.

Example: maintained

analyst_name Analyst Field Name

The name of the analyst.

Example: David Vogt

firm Analyst Field Firm

The firm the analyst is working for.

Example: UBS

recommendation Analyst Field Recommendation

The recommendation the analyst gave out.

Example: hold

sector Market General Sector

The financial sector of the ticker. Empty if unknown or not applicable such as ETF/Index.

Example: Technology

target Analyst Field Target Price

The target price of the rating.

Example: 190.0

ticker Analyst Sector

A financial sector.

timestamp Analyst Field Time

The UTC timestamp, when the rating was released.

Example: 2023-09-08T12:21:10Z

Try It GET

API Token

Query Parameters

ticker SingleTicker

limit integer

action Analyst Action

recommendation Analyst Recommendation

newer_than NewerThan

older_than OlderThan

Request Sample

curl -X GET "https://api.unusualwhales.com/api/screener/analysts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

import http.client

conn = http.client.HTTPSConnection("api.unusualwhales.com")
headers = {"Authorization": "Bearer YOUR_API_KEY", "Accept": "application/json"}
conn.request("GET", "/api/screener/analysts", headers=headers)
response = conn.getresponse()
print(response.read().decode("utf-8"))

Response Example 200

{
  "data": [
    {
      "action": "maintained",
      "analyst_name": "Tyler Radke",
      "firm": "Citi",
      "recommendation": "buy",
      "sector": "Technology",
      "target": "420.0",
      "ticker": "MSFT",
      "timestamp": "2023-09-11T11:21:12Z"
    },
    {
      "action": "maintained",
      "analyst_name": "Mark Rothschild",
      "firm": "Canaccord Genuity",
      "recommendation": "hold",
      "sector": "Conglomerates",
      "target": "11.75",
      "ticker": "DRETF",
      "timestamp": "2023-09-11T11:11:32Z"
    }
  ]
}