The Market Context Content endpoint allows context aware, popular news to be retrieved. This looks at the Top Content (see Top Content for details of consensus top content) across the entire consensus, and identifies the most popular story for each of the financial entities included in the query.

For example, this can be used in conjunction with the Top Searches endpoint to return the most popular piece of content for each of the most popular search terms over a period.

📘

Prerequisites

Before obtaining meaningful data from this API ensure that

  • You have you API apikey. Contact us to find out how to get access.
  • To get consensus insights, it is vital to ensure that behaviour capture is properly installed on your user platform. Without capturing user interactions, the API's will be unable to return any relevant user analytics or insights.

Example Call

Querying the top content API is as simple as making a call to the endpoint and including your apikey.

{
  "apikey": <your api key>,
  "entityids": [
    "AAPL"
  ]
}
curl -X 'POST' \
  'https://personafinai.azurewebsites.net/v2/consensus/content/top' \
  -H 'accept: */*' \
  -H 'Content-Type: application/json' \
  -d '{
  "apikey": <your api key>,
  "entityids": [
    "AAPL"
  ]
}'

The API will return a list of content objects, fully described in Request/Response

Request/Response

Request Object

The API request expects the following endpoint url and body parameters

POST https://personafinai.azurewebsites.net/v2/consensus/content/marketcontext

FieldDescription
apikey
string
Authentication key to use to retrieve data
entityids
_Array
A list of instruments, tickers, or other symbols of interest when retrieving market context content

Response Object

The API will respond with an List of content objects containing full details of the content.

Complete details of the content objects returned can be found in Anatomy of a Content Object

Example Response

{
    "fxcid": "44e32a34c27b415c8f29b050f6e50bb0",
    "publisherid": "6299a0723d954934980299568664f74a",
    "contenettypeid": "daa7632ac81a4cb5a96f4bcee228e527",
    "publishergontentid": "35101454",
    "version": "v1",
    "type": "Text",
    "datetimepublished": "2023-10-05T07:27:39+00:00",
    "unixdatetimepublished": 1696490859,
    "datetimecreated": "2023-10-05T07:27:39+00:00",
    "unixdatetimecreated": 1696490859,
    "datetimeupdated": "2023-10-05T07:27:39+00:00",
    "unixdatetimeupdated": 1696490859,
    "entities": [],
    "topics": [],
    "components": [
      {
        "role": "story",
        "contentmetadata": {
          "language": "en",
          "slugline": null,
          "headline": "&#39;Rich Dad, Poor Dad&#39; Author Robert Kiyosaki Says &#39;Time To Buy Apple&#39; If Stock Drops Below This Level",
          "description": null,
          "keywords": [
            {
              "value": "Brandon Nispel",
              "type": "BZTag"
            },
            {
              "value": "Eurasia",
              "type": "BZTag"
            },
            {
              "value": "KeyBank Capital Markets",
              "type": "BZTag"
            },
            {
              "value": "Robert Kiyosaki",
              "type": "BZTag"
            },
            {
              "value": "Equities",
              "type": "BZChannel"
            },
            {
              "value": "Long Ideas",
              "type": "BZChannel"
            },
            {
              "value": "News",
              "type": "BZChannel"
            },
            {
              "value": "Top Stories",
              "type": "BZChannel"
            },
            {
              "value": "Tech",
              "type": "BZChannel"
            },
            {
              "value": "Trading Ideas",
              "type": "BZChannel"
            }
          ],
          "authors": [
            {
              "name": "Shanthi Rexaline",
              "username": null,
              "role": "reporter",
              "profileImageurl": null
            }
          ],
          "securities": [
            {
              "name": "AAPL",
              "idenifier": "AAPL",
              "idenifiertype": "Symbol",
              "exchange": "NASDAQ"
            }
          ]
        },
        "content": "<p><strong>Robert Kiyosaki, </strong>the author of the best-selling book, &#8220;Rich Dad, Poor Dad,&#8221; apparently thinks <strong>Apple, Inc. </strong>(NASDAQ:<a class=\"ticker\" href=\"https://www.benzinga.com/stock/AAPL#NASDAQ\">AAPL</a>) is investment-worthy despite the tech giant&#8217;s <a href=\"https://www.benzinga.com/analyst-ratings/analyst-color/23/10/35081449/apples-growth-engine-sputtering-bullish-analyst-lists-4-factors-behind-stock-downgr\">recent fundamental challenges </a>and the broader market gloominess amid an uncertain economic environment.</p>\n\n\n\n<p><strong>What Happened:</strong> &#8220;Tim Cook dumps his share of Apple. Keybank downgrades Apple. I still love Apple,&#8221; said Kawasaki in a post on X, formerly Twitter.</p>\n\n\n\n<p>The Japanese-American businessman&#8217;s comments came close on the heels of <a href=\"https://www.benzinga.com/markets/equities/23/10/35094604/apple-ceo-tim-cook-executives-sell-over-100m-in-stock-harbinger-of-iphone-15-flop-or-diversifyin\">a slew of Apple executives selling shares</a> but the disposal was according to pre-arranged trading plans. Cook alone sold 511,000 shares worth about $87.8 million, his first sale in a little over two years. </p>\n\n\n\n<p>On Wednesday, KeyBanc Capital Markets analyst Brandon Nispel downgraded Apple stock from Overweight to Sector Weight, citing four factors, including valuation and soft U.S. trends. The risk-reward proposition for the stock is neutral, given the lack of any meaningful catalyst, Nispel said in the downgrade note.</p>\n\n\n\n<p>Kiyosaki said he did not own any Apple stock. &#8220;Maybe time to buy Apple if Apple shares drop below $150,&#8221; he said.</p>\n\n\n\n<p><em>See Also:<a href=\"https://www.benzinga.com/money/everything-you-need-to-know-about-apple-stock\"> Everything You Need To Know About Apple Stock</a></em></p>\n\n\n\n<p><strong>Why It&#8217;s Important: </strong>Notwithstanding the duo of negative catalysts, Apple shares closed Wednesday&#8217;s session up 0.73% at $173.66, according to <a href=\"https://benzinga.grsm.io/lxquj26b2sag\">Benzinga Pro data. </a>The stock is trading 12.4% off its all-time intraday high of  $198.23 hit on July 19 but has gained over 34% so far this year.</p>\n\n\n\n<p>The average analysts&#8217; price target, based on data compiled by TipRanks, is $207.69, suggesting a scope for a 19.60% upside.</p>\n\n\n\n<p>The reception to Apple&#8217;s newest iPhone iterations has been lukewarm. China&#8217;s clampdown on banning iPhones from government offices also poses a risk to the uptake of the devices in one of Apple&#8217;s key markets. Additionally, <a href=\"https://www.benzinga.com/analyst-ratings/analyst-color/23/09/34304680/why-this-hedge-fund-manager-plans-to-short-apple-stock-ahead-of-iphone-15-launch-ne\">Huawei, which was stymied by U.S. bans, has come back with a vengeance</a> and launched a smartphone that has been well-received by Chinese investors.</p>\n\n\n\n<p>Apple has been touting developing markets such as India as offering huge sales potential and accordingly channeling resources into these markets. </p>\n\n\n\n<p><em>Read Next: <a href=\"https://www.benzinga.com/analyst-ratings/analyst-color/23/05/32257067/apple-drums-up-emerging-focus-on-earnings-call-gurman-weighs-in-one-strategy-that-c\">Apple Drums Up Emerging Market Focus On Earnings Call; Gurman Weighs In On One Strategy That Could Help Cupertino Win Big In This Frontier</a></em></p>"
      }
    ],
    "images": [],
    "timestampprocessed": "2023-10-05T07:27:40.2687637+00:00",
    "unixtimestampprocessed": 1696490860,
    "url": "https://www.benzinga.com/markets/equities/23/10/35101454/rich-dad-poor-dad-author-robert-kiyosaki-says-time-to-buy-apple-if-stock-drops-below-this-level"
  }
Language
Click Try It! to start a request and see the response here!