# Analyst ratings snapshot

The analyst ratings snapshot endpoint provides a streamlined summary of ratings from analyst firms for both US and international markets. It delivers essential data on analyst recommendations, including buy, hold, and sell ratings, allowing users to quickly assess the general sentiment of analysts towards a particular stock.

**API credits cost:** `75` per symbol

> **Note:** This API endpoint is available starting with the [Ultra](https://twelvedata.com/pricing) plan.

## Parameters

- `symbol` (string, optional, see notes)
  Filter by symbol


- `figi` (string, optional, see notes)
  Filter by financial instrument global identifier (FIGI). This request parameter is available starting with the Ultra plan


- `isin` (string, optional, see notes)
  Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section


- `cusip` (string, optional, see notes)
  The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section


- `country` (string, optional)
  Filter by country name or alpha code, e.g., `United States` or `US`


- `exchange` (string, optional)
  Filter by exchange name


- `rating_change` (string, optional)
  Filter by rating change action


- `outputsize` (integer, optional)
  Number of records in response


**Notes:**

 - At least one of the following parameters is required: `symbol`, `figi`, `isin`, `cusip`.

## Response

- `meta` (object)
  Meta information about the instrument
  - `symbol` (string)
    Symbol ticker of the instrument
  - `name` (string)
    Name of the instrument
  - `currency` (string)
    Currency in which the instrument is traded
  - `exchange_timezone` (string)
    Timezone of the exchange
  - `exchange` (string)
    Exchange where the instrument is traded
  - `mic_code` (string)
    Market identifier code (MIC) under ISO 10383 standard
  - `type` (string)
    Type of the instrument

- `ratings` (array of object)
  List of analyst ratings
  - `date` (string)
    Date when the rating was released
  - `firm` (string)
    Firm that issued the ranking
  - `rating_change` (string)
    Defines the action of the firm to ranking, could be `Maintains`, `Upgrade`, `Downgrade`, `Initiates` or `Reiterates`
  - `rating_current` (string)
    Current firm's ranking of the instrument
  - `rating_prior` (string)
    Prior firm's ranking of the instrument

- `status` (string)
  Response status


## Example Request

```bash
curl "https://api.twelvedata.com/analyst_ratings/light?symbol=AAPL&apikey=demo"
```

## Example Response

```json
{
    "meta": {
        "symbol": "AAPL",
        "name": "Apple Inc",
        "currency": "USD",
        "exchange_timezone": "America/New_York",
        "exchange": "NASDAQ",
        "mic_code": "XNGS",
        "type": "Common Stock"
    },
    "ratings": [
        {
            "date": "2022-08-19",
            "firm": "Keybanc",
            "rating_change": "Maintains",
            "rating_current": "Overweight",
            "rating_prior": "Overweight"
        }
    ],
    "status": "ok"
}
```