# Recommendations (High demand)

The recommendations endpoint provides a summary of analyst opinions for a specific stock, delivering an average recommendation categorized as Strong Buy, Buy, Hold, or Sell. It also includes a numerical recommendation score, offering a quick overview of market sentiment based on expert analysis.

**API credits cost:** `100` 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)
  The FIGI of an instrument for which data is requested. 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)
  The country where the instrument is traded, e.g., `United States` or `US`


- `exchange` (string, optional)
  The exchange name where the instrument is traded, e.g., `Nasdaq`, `NSE`.


**Notes:**

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

## Response

- `meta` (object)
  Metadata about the symbol
  - `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

- `trends` (object)
  Analyst recommendations trends
  - `current_month` (object)
    Current month recommendations
    - `strong_buy` (integer)
      Number of analysts that give a strong buy recommendation
    - `buy` (integer)
      Number of analysts that give a buy recommendation
    - `hold` (integer)
      Number of analysts that give a hold recommendation
    - `sell` (integer)
      Number of analysts that give a sell recommendation
    - `strong_sell` (integer)
      Number of analysts that give a strong sell recommendation
  - `previous_month` (object)
    Previous month recommendations
    - `strong_buy` (integer)
      Number of analysts that give a strong buy recommendation
    - `buy` (integer)
      Number of analysts that give a buy recommendation
    - `hold` (integer)
      Number of analysts that give a hold recommendation
    - `sell` (integer)
      Number of analysts that give a sell recommendation
    - `strong_sell` (integer)
      Number of analysts that give a strong sell recommendation
  - `2_months_ago` (object)
    Two months ago recommendations
    - `strong_buy` (integer)
      Number of analysts that give a strong buy recommendation
    - `buy` (integer)
      Number of analysts that give a buy recommendation
    - `hold` (integer)
      Number of analysts that give a hold recommendation
    - `sell` (integer)
      Number of analysts that give a sell recommendation
    - `strong_sell` (integer)
      Number of analysts that give a strong sell recommendation
  - `3_months_ago` (object)
    Three months ago recommendations
    - `strong_buy` (integer)
      Number of analysts that give a strong buy recommendation
    - `buy` (integer)
      Number of analysts that give a buy recommendation
    - `hold` (integer)
      Number of analysts that give a hold recommendation
    - `sell` (integer)
      Number of analysts that give a sell recommendation
    - `strong_sell` (integer)
      Number of analysts that give a strong sell recommendation

- `rating` (number)
  Rating from 0 to 10 represents overall analysts' recommendation. 0 to 2 - strong sell, 2 to 4 - sell, 4 to 6 - hold, 6 to 8 - buy, 8 to 10 - strong buy.

- `status` (string)
  Response status


## Example Request

```bash
curl "https://api.twelvedata.com/recommendations?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"
    },
    "trends": {
        "current_month": {
            "strong_buy": 13,
            "buy": 20,
            "hold": 8,
            "sell": 0,
            "strong_sell": 0
        },
        "previous_month": {
            "strong_buy": 13,
            "buy": 20,
            "hold": 8,
            "sell": 0,
            "strong_sell": 0
        },
        "2_months_ago": {
            "strong_buy": 13,
            "buy": 20,
            "hold": 8,
            "sell": 0,
            "strong_sell": 0
        },
        "3_months_ago": {
            "strong_buy": 13,
            "buy": 20,
            "hold": 8,
            "sell": 0,
            "strong_sell": 0
        }
    },
    "rating": 8.2,
    "status": "ok"
}
```