User needs API

Your credentials

Please treat the API key as a secret and keep it server-side. It should never appear in browser code or in a public repository. Let us know if it needs to be rotated at any point.

POST https://api.smartocto.com/api/integrations/v2/<brandId>/ai/untagger  

Content-Type: application/json 
Authorization: <your API key>

{   
   "batch": [     
      { "text": "Full text of the first article ..." },     
      { "text": "Full text of the second article ..." }   
    ] 
}

Usage limits – please observe these

• Send at most five texts per batch.
• Leave at least five seconds between consecutive requests.

If you need to process a larger archive in one go, please get in touch beforehand so we can plan it together rather than have the throughput limited unexpectedly.

{   
  "batch": [     
     {       
       "text": "Light rain falls as the first passenger train in more than a
       decade pulls into Westhaven Central. The station, closed since the
       regional dispute of 2014, reopened this week after an eighteen-month
       reconstruction financed jointly by the national government and a
       consortium of foreign lenders. For the roughly 240,000 residents of
       the coastal province, the line restores a four-hour connection to the
       capital that until now required a full day by road. Officials at the
       ceremony framed the reopening as a test case. 'Infrastructure is the
       least controversial place to begin,' said the regional transport
       commissioner, who has spent two years negotiating with the
       administrations on either side of the river. Not everyone shares the
       optimism. Freight operators point out that the single track limits
       capacity to six services a day, and that the rolling stock has been
       leased rather than bought. Analysts note that the reconstruction
       budget has already been revised twice, and that no agreement has yet
       been reached on who maintains the line beyond the first three years."
     }
   ]
 }

{
     "request_id": "1790254219000",
     "response": [
         {
             "response": {
                 "action_driven": {
                     "connect_me": 60,
                     "help_me": 40,
                     "score": 5
                 },
                 "context_driven": {
                     "educate_me": 42,
                     "give_me_perspective": 58,
                     "score": 41
                 },
                 "emotion_driven": {
                     "divert_me": 33,
                     "inspire_me": 67,
                     "score": 8
                 },
                 "explanation": "This article is primarily Fact-driven with 
     strong Context-driven elements. The author's dominant intention is to 
     report a concrete event, answering the classic who, what, where and 
     when questions around the reopening of the line. A substantial part of
     the text is nevertheless devoted to background: the origin of the 
     dispute, how the reconstruction was financed, and the unresolved 
     questions around capacity and long-term maintenance. Within 
     Context-driven, 'Give me perspective' outweighs 'Educate me' because 
     the piece assumes familiarity with the underlying dispute and 
     concentrates instead on what the reopening means for the region and 
     its neighbors. Emotion-driven and Action-driven are both marginal: the 
     article makes no emotional appeal and offers the reader no practical 
     guidance or call to action.",
                 "fact_driven": {
                     "keep_me_engaged": 57,
                     "score": 46,
                     "update_me": 43
                 }
             },
             "status": "success"
         }
     ],
     "status": "success"
 }

The one thing worth internalising

A high sub-need percentage inside a low-scoring category is still small in absolute terms. In the example, inspire_me reads 67, but it is 67 % of a category worth only 8 – roughly 5 points of the article overall. To get the absolute weight of a sub-need, multiply it by its category score. Reading sub-need numbers on their own is the most common way these results get misinterpreted.