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.
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.
Menu
Analyst Ratings API endpoints
GET |
/api/v1/companyratings |
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.
Filters | ||
company_ticker |
date_to |
|
analyst_name |
|
|
analyst_firm |
|
|
rated |
|
|
date_from |
|
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",
}
},
SDK
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
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.

Menu