---
title: "Company Ratings"
method: GET
path: "/companyratings"
tags: ["Company Ratings"]
---

# Company Ratings

`GET /companyratings`

The Company Rating Endpoint delivers real-time buy/sell/hold analyst ratings, updated as new reports are published. It also provides 15+ years of historical ratings and price targets to track trends and analyst performance over time.


**Note:** Rate limit is enforced to 1 API call per minute.

## Query parameters

- `access_key` string, required
- `ticker` string, required
- `date_from` string, date
- `date_to` string, date
- `rated` 'buy' | 'sell' | 'hold'

## Response `200`

Company ratings data retrieved.

- CompanyRatingsResponse
  - `status` CompanyRatingsResponseStatus
    - `code` integer — HTTP status code.
    - `message` string — Status message.
    - `details` string — Additional details.
  - `result` CompanyRatingsResponseResult
    - `basics` CompanyRatingsResponseResultBasics
      - `company_name` string — Name of the company.
      - `ticker` string — Ticker symbol.
    - `output` CompanyRatingsResponseResultOutput
      - `analyst_consensus` CompanyRatingsResponseResultOutputAnalystConsensus
        - `consensus_conclusion` string — Consensus conclusion.
        - `stock_price` string — Current stock price.
        - `analyst_average` string — Analyst average price target.
        - `analyst_highest` string — Highest analyst price target.
        - `analyst_lowest` string — Lowest analyst price target.
        - `analysts_number` string — Number of analysts.
        - `buy` string — Number of buy ratings.
        - `hold` string — Number of hold ratings.
        - `sell` string — Number of sell ratings.
        - `consensus_date` string — Date of consensus (YYYY-MM-DD).
      - `analysts` CompanyRatingsResponseResultOutputAnalysts[]
        - `analyst_name` string — Name of the analyst.
        - `analyst_firm` string — Analyst's firm.
        - `analyst_role` string — Role of the analyst.
        - `rating` CompanyRatingsResponseResultOutputRating
          - `date_rating` string — Date of the rating (YYYY-MM-DD).
          - `target_date` string — Target date for the rating (YYYY-MM-DD).
          - `price_target` string — Analyst's price target.
          - `rated` string — Analyst's rating (Buy/Sell/Hold).
          - `conclusion` string — Analyst's conclusion (e.g.,

---

[API](https://skmtc.net/beavermoney/apis/marketstack-api-v2.md) · [All operations](https://skmtc.net/beavermoney/apis/marketstack-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/beavermoney/marketstack-api-v2/revisions/c3305aea713e/schema)