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":[{
  "divName":"div1",
  "networkId":23,
  "siteId":667480,
  "adTypes":[5]}],
  "user":{"key":"abc"}}' \
  \
  https://e-23.adzerk.net/api/v2
Copy

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": "https://e-123.kevel.co...",
      "imageURL": "https://e-123.kevel.co...",
      "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

Test out our APIs today

No API key needed!

Test in JSFiddle

import adzerk_decision_sdk

# Demo network, site, and ad type IDs; find your own via the Kevel UI!
client = adzerk_decision_sdk.Client(23, site_id=667480)

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

response = client.decisions.get(request)
print(response)
Copy

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