# Norn API

Source: https://docs.native.no/norn

> **Preview.** The Norn API is not live yet. This page describes the planned interface; names and fields can change before access opens.

Norn predicts which idea people will respond to, before anything is published. The API will let any product ask it for ranked ideas.

> **Not live yet.** The Norn API opens from a [waitlist](https://native.no/meet-norn?from=docs#waitlist). These pages describe the interface we are building, so you can plan against it before your access opens. Names and fields can still change before access opens.

## An idea factory you can call

Norn is the model behind the ideas Native suggests to its customers, more than 2,200 businesses. It does not write posts. It decides what a post should be: the point to make, the angle to take, the format, and why it fits now.

The API opens that up to any product. Send Norn a brand, and it sends back ideas in order, best first. Each idea says why it should work now and cites where it came from, such as a page on the brand’s website or a customer review. The model you already use writes the post from there.

## Why not ask a language model?

Language models are very good at writing. They are not good at knowing what to talk about. They are trained to predict the most likely next word, so their ideas drift toward the average, and the average is what people scroll past.

Norn is built around a different question: which idea will stand out for this brand, with this audience, at this moment. It answers from what people actually do with ideas: which ones they approve, rewrite or turn down, and how the posts perform once they are out. We call that artificial intuition.

## What you send, what you get back

1. **A brand.** Its website, language and country, and any rules you set. Norn reads the website once and keeps what it learns. See [Brands](https://docs.native.no/norn/brands).
2. **A request for ideas.** How many you want, in which formats, and anything Norn should focus on. See [Ideas](https://docs.native.no/norn/ideas).
3. **Ranked ideas back.** Each has a hook, an angle, a reason it fits now, its sources, an outline and a prompt for a generative model.
4. **Feedback from you.** What people did with each idea and how the post performed. Norn uses it to learn the brand’s taste. See [Feedback](https://docs.native.no/norn/feedback).

## The calls

| Call | What it does | Status |
| --- | --- | --- |
| [`POST /v1/brands`](https://docs.native.no/norn/brands) | Creates a brand from a website and anything you know about it. | Preview |
| [`POST /v1/ideas`](https://docs.native.no/norn/ideas) | Starts a batch of ranked ideas for a brand. Fetch it with `GET /v1/ideas/{batch_id}` when it is done. | Preview |
| [`POST /v1/feedback`](https://docs.native.no/norn/feedback) | Tells Norn what happened to an idea. | Preview |
| [`POST /v1/predictions`](https://docs.native.no/norn/predictions) | Ranks drafts you already have, before they go out. | In development |

## How Norn learns

Every idea Native suggests leaves a trail: the idea, what the customer did with it, and how the post performed. That trail is what Norn learns from. When customers turn ideas down and say why, Norn turns the reasons into lessons for that brand. When a post does better than the brand’s usual, Norn notes what made it work.

The API is built to feed the same loop. The more you tell Norn about what happened to its ideas, the better the next ones fit.

## What is ready, and what is not

- Brands, ideas and feedback make up the first preview. They are what Native runs on today, opened up as an API.
- Predictions for drafts you already have are in development. The [Predictions](https://docs.native.no/norn/predictions) page shows the plan.
- There is no SDK yet. The API is JSON over HTTPS, and every example comes in cURL, TypeScript and Python.
- Pricing is not set yet. You will see the price before you are charged anything.

## Next steps

- [Quickstart](https://docs.native.no/norn/quickstart): From your credentials to your first ranked ideas.
- [Ideas](https://docs.native.no/norn/ideas): What an idea holds, and how to ask for good ones.
- [Brands](https://docs.native.no/norn/brands): What Norn reads from a website, and how to correct it.
- [FAQ](https://docs.native.no/norn/faq): What is live, what it costs, and how Norn differs from a chat model.