/page

How to send Page Views using the HTTP API

The HTTP API enables you to send user Page Views to Adnuntius Data.

Typically you are recommended to send these events from the user's browser using the Javascript API.

Request object

Data is sent to Adnuntius using a HTTP POST request, with a JSON payload containing the fields described below. A separate object is required for each page view event.

If the request is received correctly, an HTTP 200 status code will be returned.

Example request object

POST https://data.adnuntius.com/page

{
  "browserId": "123xyz",
  "folderId": "00000000000123ab",
  "keywords": ["sport", "tennis"],
  "categories": ["IAB_24_44"],
  "domainName": "sport.no"
}

Field Descriptions

Name	Type	Description
browserId	String	A unique ID for the browser or device being used.
folderId	String	The Folder ID in Adnuntius Data, for example: 00000000000123ab You can also specify the folderId as a parameter in the request URL.
keywords	String[]	An array of keywords
categories	String[]	An array of categories
domainName	String	The domain name of the page

Example cURL request

This is a very simple example, using curl, demonstrating how a page view is sent to Adnuntius Data.

curl -H "Content-Type: application/json" https://data.adnuntius.com/page -d '{
  "browserId": "123xyz",
  "folderId": "00000000000123ab",
  "keywords": ["sport", "tennis"],
  "categories": ["IAB_24_44"],
  "domainName": "sport.no" }'

Example batch request

Page views can also be sent to adnuntius in bulk by adding them to an array like this:

[
  {
    "browserId": "123xyz",
    "folderId": "00000000000123ab",
    "keywords": ["sport", "tennis"],
    "categories": ["IAB_24_44"],
    "domainName": "sport.no"
  },
  {
    "browserId": "123xyz",
    "folderId": "00000000000123ab",
    "keywords": ["sport", "tennis"],
    "categories": ["IAB_24_44"],
    "domainName": "sport.no"
  }
]

See here how you can send pageview information using the JavaScript API instead.