Analyst Ratings API

Analyst ratings API for fetching historical and real-time buy/sell/hold analyst ratings
The analyst ratings API of Finnworlds maintains data with the purpose of fetching historical and real-time buy/sell/hold analyst ratings. Several examples of the type of business that uses it are investment platforms, stock market-related websites, business platforms, stock market analysts, business analysts, investment analysis and forecasting, and more, usually they can be small business, medium business and enterprises in the investment, stock market, finance and business industry. With the system you are able to filter determined by company_ticker, analyst_name, analyst_firm, rated, date_from and date_to to attain the response output you would like. It is always exciting to read about new programs using the analyst stock ratings data, you can realise several use cases with the API but some ideas are; applications, website plugins, investment platforms and stock market analysis, stock market forecasting, machine learning projects and more. Programmers frequently realise innovative ways to make use of the data from the API system and design new products. This database has regional data coverage available.

Analyst Ratings API endpoints

GET /api/v1/companyratings
In order to receive a data response as in the example response, you need to connect to the analyst stock ratings API endpoint by sending a GET request to the endpoint; /api/v1/companyratings with the required object parameters. For the applicable objects and parameters, check the object table of the analyst ratings API that explains it all. The API documentation applies to all major programming languages, simply include your API key parameter to the data endpoint URL and set it to your personal key to start receiving the required data. In order to apply for the data request, put the data endpoint into the URL field.

API filtering parameters for analyst ratings data

Below you will see the available filter parameters for the analyst ratings data.
company_ticker date_to

Analyst ratings API object attributes

Make a data request with the parameters applicable and make use of the table to clarify the objects with their related description.
Objects Description
company_name Name of company
company_ticker Ticker symbol of company
consensus_conclusion The average of all analysts in words: buy, hold, sell
analyst_average Average price target of analysts with a 12 month price target
analyst_highest Highest rating of analysts
analyst_lowest Lowest rating of analysts
buy Number of analysts with a Buy rating
hold Number of analysts with a Hold rating
sell Number of analysts with a Sell rating
analyst_name Name of the analyst giving the rating
analyst_firm Firm where the analyst works who makes the rating
analyst_role The job or function of the analyst
price_target The price target of the analyst
target_date The target date to which the price target applies, usually 12 months later
rated Buy hold sell rating of an analyst
conclusion Weither the analyst reiterated, maintained, started covering, or other

Analyst ratings output response

Here clients may find the response output example. Opt-in to the full response output due to this being limited to be able to make it readable.
    "status": {
        "code": 200,
        "message": "OK",
        "details": ""
    "result": {
        "basics": {
            "company_name": "Apple Inc",
            "company_ticker": "AAPL"
        "output": {
            "analyst_consensus": {
                "consensus_conclusion": "",
                "analyst_average": "181.65",
                "analyst_highest": "220.00",
                "analyst_lowest": "136.00",
                "analysts_number": "28",
                "buy": "22",
                "hold": "5",
                "sell": "1",
                "consensus_date": "2022-10-18"
            "analysts": [
                    "analyst_name": "ivan-feinseth",
                    "analyst_firm": "Tigress Financial",
                    "analyst_role": "analyst",
                    "rating": {
                        "date_rating": "2022-10-04T00:00:00",
                        "price_target": "210.0",
                        "target_date": "2023-10-04",
                        "rated": "Buy",
                        "conclusion": "reiterated",
                    "analyst_name": "samik-chatterjee",
                    "analyst_firm": "J.P. Morgan",
                    "analyst_role": "analyst",
                    "rating": {
                        "date_rating": "2022-10-03",
                        "price_target": "None",
                        "target_date": "2023-10-03",
                        "rated": "Buy",
                        "conclusion": "maintained",
                    "analyst_name": "erik-woodring",
                    "analyst_firm": "Morgan Stanley",
                    "analyst_role": "analyst",
                    "rating": {
                        "date_rating": "2022-10-03",
                        "price_target": "180.0",
                        "target_date": "2023-10-03",
                        "rated": "Buy",
                        "conclusion": "maintained",
                    "analyst_name": "angelo-zino",
                    "analyst_firm": "CFRA",
                    "analyst_role": "analyst",
                    "rating": {
                        "date_rating": "2022-10-01",
                        "price_target": "175.0",
                        "target_date": "2023-10-01",
                        "rated": "Buy",
                        "conclusion": "maintained",


Use any of the filter attributes to filter the analyst recommendations data that is needed. The API platform provides output in JSON file format and for programming languages like; phyton, r, matlab, c++, node. Js, go, php, haskell, net, java, javascript, typescript, tensorflow and ruby there are software development kits accessible, just ask for it and it is provided soon.

Analyst Ratings API pricing

Samples and trials access is freely available if requested, simply write an email and ask for it. Clients will be able to use the analyst recommendations data and find out if this is precisely what clients are seeking for. After testing the API, people can decide if they want to continue with the paid version.

API cost

Finnworlds data access is available to purchase monthly from $99 including documentation and provider support.
Option Price
Monthly subscription From $99/month
Variable pricing no

Discounted Trial

Discounted trial is available

More info

The data goes back until from the first rating of the analyst, this makes it possible to receive historical analyst stock ratings data with the API too.

Alternative options


Stock Market Index API
Stock Market Index API presents Stock Market datasets to build fetching all the real-time and historical stock market benchmarks and indexes of all regions and countries in the world goals to advance businesses around the world. The stock market index API is the ideal data tool to precisely receive Stock Market data to your API client.


Bond Yields API
This bond yields API provides a gigantic amount of Bond data with the entire details you want. Bond Yields API grants external data solutions to build projects for fetching real-time government bond data of different countries, regions and timeperiods objectives.

Sign up for Finnworlds analyst ratings API

Get Data Access

~[ ∵ ]~

Sign-up Succesful

Wait for the Data