The personalized content get API is used to retrieve the most recent content items that are relevant to the specified user, according to their preferences and behaviours.

📘

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 personalise responses it is vital to capture an end user identifier as part of behaviour capture. Without such user ids, the api will not be able to return personalized content.

Example Call

Querying the Personalized content API is as simple as making a call to the endpoint and including your apikey and a valid end user id.

{
  "apikey": <your apikey>,
  "max_results": 10,
  "customer_enduser_id": <end user id>
}

curl -X 'POST' \
  'https://personafinai.azurewebsites.net/v2/personalized/entity/recommended' \
  -H 'accept: */*' \
  -H 'Content-Type: application/json' \
  -d '{
  "apikey": <your apikey>,
  "max_results": 10,
  "customer_enduser_id": <end user id>
}'

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/personalized/content/get

FieldDescription
apikey
string
Authentication key to use to retrieve data
maxresults
_int
The number of results to return
customerenduser_id
_string
Value used to identify user on target platform

Response Object

The API will respond with a list of content objects.

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!