API

This section is for developers. If you have not read Getting started yet, it says what Neuwo returns and how else it can reach your pages.

Two APIs

Each has its own token and base URL, and a token issued for one does not work on the other. Both are issued by Neuwo together with the endpoint URL: contact Neuwo or email adops@neuwo.ai, as there is no self-service signup.

The EDGE API takes a URL. Neuwo fetches the published page and analyses it. It is built for calls from the browser, and it is the API Bid Enrichment runs on, by both the Prebid module and the Google Ad Manager route.
The Auto-Tagging API takes the text itself, for content that is not published yet or has no public address. It is a server-side call.

Make your first call

One request to the EDGE API, with the token and the page you want analysed:

curl -H "origin: https://example.com" "https://ctx.neuwo.ai/api/aitopics/edge/GetAiTopics?token=YOUR_TOKEN&url=https://example.com/article"

Three things decide whether this works:

The base URL is the endpoint Neuwo issued you. ctx.neuwo.ai is the shared one; if you were given your own, use that instead.
The origin header is required, and it names the site the request comes from. Your endpoint answers the origins it is configured for and refuses the rest.
The first call for a new URL usually returns a message instead of categories. Neuwo queues the page, which typically takes 10 to 60 seconds. Call again after that and the categories are there.

A 401 means the token is wrong or missing, and a 403 means the token is valid but is not allowed to do this.

Read the response

Trimmed to one entry per block, this is the shape:

{
  "tags": [
    {
      "URI": "https://tags.neuwo.ai/masterID101332",
      "value": "Domestic Animals and Pets",
      "score": "0.79728"
    }
  ],
  "brand_safety": { "BS_score": "1.0", "BS_indication": "yes" },
  "marketing_categories": {
    "iab_tier_1": [{ "ID": "IAB16", "label": "Pets", "relevance": "0.54" }]
  },
  "smart_tags": [{ "ID": "123", "name": "animals-group" }]
}

tags is the subject in Neuwo's own vocabulary, each with a unique URI and a score.
brand_safety comes back in one of two shapes, either BS_score and BS_indication or score and indication, so read it defensively.
marketing_categories holds the standard sets: iab_tier_1 to iab_tier_3, iab_audience_tier_3 to iab_audience_tier_5, Google Topics, and any custom categories built for you.
smart_tags is present only if smart tags are enabled for your account.

Scores and relevances are strings, not numbers. Parse before you compare them.

If Neuwo could not analyse the page, the response carries an error message rather than any of these blocks.

Reference

Every endpoint, parameter and response, with a request builder.

API reference

SDKs

Per-endpoint code samples for each SDK are shown inside the reference next to the endpoint they belong to. These pages cover installation, authentication and a full walkthrough.