Norn APIThe API
In developmentPredictions
In development: send the drafts you already have, and Norn ranks them before they go out, with how likely each is to beat the brand’s usual post.
Ideas answer "what should we post?". Predictions answer the question that comes after: "of the posts we have, which one will land?". Send Norn drafts from your team, your own models or your customers, and it ranks them before anything is published.
What the numbers mean
#score is Norn’s estimate of the chance a draft beats the brand’s usual post on engagement, from 0 to 1. A score of 0.74 means Norn expects the draft to do better than the brand’s typical post about three times in four.
confidence says how much evidence stands behind the score, from 0 to 1. It starts low for a new brand and rises as outcomes come back through feedback. A high score with low confidence is a guess. Treat it like one.
Acting on a prediction
#Both numbers are meant to be used in code. A common pattern: publish on your own when both are high, and ask a person when they are not.
TypeScript
const [top] = result.data
if (top.score >= 0.7 && top.confidence >= 0.5) {
await schedule(top.id)
} else {
await askForReview(top.id)
}Create predictions
#/v1/predictionsIn developmentBody
brandstringRequiredThe id of a brand whose
statusisready.candidatesobject[]RequiredThe drafts to rank, from 2 to 20.
idstringRequiredYour own id for the draft. It comes back with its prediction.
textstringRequiredThe draft’s words.
formatstringOptionalThe format it will go out in.
One of:
image,carousel,video,text
curl -X POST https://api.native.no/v1/predictions \
-H "Authorization: Bearer $NATIVE_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"brand": "brand_7Hk2pQ",
"candidates": [
{
"id": "draft-a",
"text": "Frozen pipes do not care that it is Sunday. We do. Same-day fix, no drama.",
"format": "video"
},
{
"id": "draft-b",
"text": "Winter is here. Book your annual plumbing inspection today.",
"format": "image"
}
]
}'Response
{
"object": "list",
"model": "norn-preview",
"brand": "brand_7Hk2pQ",
"data": [
{
"object": "prediction",
"id": "draft-a",
"rank": 1,
"score": 0.74,
"confidence": 0.41
},
{
"object": "prediction",
"id": "draft-b",
"rank": 2,
"score": 0.22,
"confidence": 0.41
}
]
}What it will not do at first
#- It reads words only. To rank a picture or a video, describe it in
text. - It ranks drafts within one brand. It does not compare brands with each other.
- A score is for ranking and for thresholds. It is not a forecast of reach, clicks or sales.
The Norn API is not open yet
Access opens from the waitlist. Join it and we will email you when your access is ready.