How do the JSON output and object description table of analyst ratings API of Finnworlds work?
In this article, I will provide a clear understanding of the object table and JSON output in Finnworld's analyst ratings API. As a programmer, you already have a good grasp of what these concepts are, but it can still be helpful to have a more detailed explanation of how they work within the context of this specific API. By the end of this article, you will have a deeper understanding of the structure and format of the data that you can expect to receive when using Finnworld's analyst ratings API.
Object and description table
| 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 | Whether the analyst reiterated, maintained, started covering, or other |
company_name: The name of the company being rated by the analysts.company_ticker: The ticker symbol of the company being rated by the analysts.consensus_conclusion: The average of all the analysts' conclusions about the company's stock, typically represented in words such as "buy," "hold," or "sell."analyst_average: The average price target for the company's stock, as determined by the analysts who have a 12-month price target.analyst_highest: The highest rating given by an analyst regarding the company's stock.analyst_lowest: The lowest rating given by an analyst regarding the company's stock.buy: The number of analysts who have rated the company's stock as a "buy."hold: The number of analysts who have rated the company's stock as a "hold."sell: The number of analysts who have rated the company's stock as a "sell."analyst_name: The name of the analyst who provided the rating.analyst_firm: The firm where the analyst works who provided the rating.analyst_role: The job or function of the analyst.price_target: The analyst's price target for the company's stock.target_date: The date to which the analyst's price target applies, usually 12 months later.rated: The rating given by an analyst regarding the company's stock, which can be a "buy," "hold," or "sell."conclusion: The conclusion made by the analyst regarding the company's stock, which can indicate whether they are maintaining, reiterating, or starting coverage on the stock, among other possibilities.
The information in the table is useful for investors and financial analysts who want to make informed decisions about a particular company's stock. The table provides a comprehensive overview of the company's stock ratings from various analysts, including the number of analysts who have rated the stock as a "buy," "hold," or "sell." The average price target and the highest and lowest ratings given by analysts also provide insight into the market's sentiment towards the stock. The analyst name, firm, and role provide additional context regarding the credibility and expertise of the analyst's rating. Overall, this information can be used to make informed investment decisions, such as whether to buy, hold, or sell a particular stock.
Json output
The given JSON output provides detailed information on the analyst consensus and ratings of Apple Inc, including the company's name, ticker, and analyst recommendations. The "status" section includes the status code and message, indicating that the API call was successful. The "result" section includes two sub-sections: "basics" and "output". The "basics" section provides the basic details of the company, including its name and ticker. The "output" section provides more detailed information about the analyst consensus and ratings, including the consensus conclusion, the number of analysts who rated the company, and the breakdown of analysts' recommendations into "buy," "hold," and "sell." Additionally, the "analysts" array includes specific information about each analyst's name, firm, role, and individual ratings, including the date of the rating, price target, target date, rated recommendation, and conclusion. This JSON output is useful for anyone interested in monitoring and analyzing the performance of Apple Inc, as it provides a comprehensive overview of the company's analyst ratings and consensus.
{
"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",
}
},
In conclusion
Today, we discussed different aspects of data and information. We started by defining data and information and highlighting the difference between the two. We then explored the importance of data quality and the potential consequences of using inaccurate or incomplete data. Next, we discussed different types of data, including structured and unstructured data, and their characteristics. Additionally, we talked about the importance of data analysis and visualization in making informed decisions based on data. Finally, we looked at an example of JSON output and described its structure and content. Overall, this conversation highlights the importance of data and information in today's world and the need for effective management and utilization of data to gain valuable insights and make informed decisions.
Endnote
Worldindata is a data marketplace that connects data buyers with data sellers, including API providers like Finnworlds. To request access to the Finnworlds analyst ratings API, one can create an account on Worldindata and search for Finnworlds in the data provider directory. From there, one can review the information about the Finnworlds API, such as the pricing and usage limits, and submit a request for access to the API. With this, the buyer can start using the Finnworlds API to retrieve analyst ratings data.