Kevel API Quickstart

1. Post

Post an ad request to Kevel when you need a decision made (no JavaScript tags needed).

curl -H 'Content-Type:application/json' \
  -X POST \
  -d '{"placements":[{
  "user":{"key":"abc"}}' \

2. Parse

Parse the JSON response from Kevel that contains info and tracking links for the winning ad.

{ "user": { "key": "abc" },
  "decisions": {
    "div1": {
      "adID": 1234567,
      "creativeID": 7654321,
      "flightID": 9876543,
      "campaignID": 3456789,
      "clickURL": "",
      "imageURL": "",
      "height": 250,
      "width": 300,

3. Place

Place the content wherever you want, such as your site, app, OOH digital property, etc.

Kevel Example Solution
Executable Code Samples

Run a quick spike of our APIs with these codes.

No API key needed!

Test in JSFiddle

import { Client } from "@adzerk/decision-sdk";

// Demo network, site, and ad type IDs; find your own via the Kevel UI!
let client = new Client({ networkId: 23, siteId: 667480 });

let request = {
  placements: [{ adTypes: [5] }],
  user: { key: "abc" },
  keywords: ["keyword1", "keyword2"]

client.decisions.get(request).then(response => {
  console.dir(response, { depth: null });

Full API Documentation

Developer Updates

Subscribe for updates and announcements of Kevel developer tools, SDKs,
updates, & events.

Get Developer Updates

Get started building the exact ad platform you want in just weeks

Start now

Kevel is a great partner, and we recommend them to anyone building a custom ad platform.
Chief Digital Officer, Bed Bath & Beyond