Announcing the Complete SiteScout API

by Ratko Vidakovic on July 23, 2013 · 3 comments

A few months ago we released the initial version of the SiteScout API, which included Reporting and Audience Management components. Today we are happy to announce the third and final component of the API: Campaign Management!

You now have the ability to fully control your campaigns through our API, with programmatic access to reporting, audience management and campaign management. This means that you can create mobile, web and desktop apps that interact directly with the SiteScout RTB platform.It also means that you can integrate the functionality and power of RTB with your own products, giving your clients that much more value.

Our CEO summed it up best:

“Our customers were asking us if they could build apps on top of our RTB platform, such as niche-specific DSPs targeting specific market segments. This is why we launched this API: to give them the right tools to create their own RTB-powered ad products. In doing so, we’re creating a richer marketing ecosystem and democratizing RTB infrastructure by making it available to developers and businesses of all sizes around the world.”
— Paul Mokbel

What can I do with it?

The API allows you to build custom dashboards, branded client interfaces, and retargeting products, among other things. Just to recap, the API consists of three main components:

Campaign Management. You can now fully control your campaigns through the SiteScout API, creating applications that interact with the SiteScout platform and infrastructure. With Campaign Management, you can do everything from creating new campaigns, to adjusting bids and turning various campaign elements on or off.

Reporting. The SiteScout API allows you to pull data from your campaigns into your own applications or databases. You receive access to real-time and historical campaign data on many levels – site, placement, creative, conversion, and so on. You can also retrieve this data on an hourly basis with various levels of granularity. By using date ranges and filters, you can “slice and dice” data as you see fit.

Audience Management. You can create and modify retargeting audiences associated with your account, and retrieve the tracking codes for audiences in various formats. You can also retrieve the stats for your audiences for any given time range, giving you the ability to track the growth of audiences over time.

The complete documentation can be found here:

Example Source Code on GitHub

We’ve also gone the extra mile to help developers get started with the new API. Our internal team has developed, and continues to actively develop, an example application that demonstrates the API’s functionality. It’s open source and can be downloaded on GitHub at:

This sample application is written in JSF and is still being actively developed by our internal team. We highly recommend stealing any pieces of code that might help you out with your own applications.

WANTED: Featured Developers!

We are looking for developers that are interested in being featured as API case studies. In exchange for allowing us to follow along and feature your development project, we will provide extra consultation and guidance to help you with your project. And, we will leverage our internal marketing resources (as well as our external PR resources) to help get your project off the ground. If you are interested in being a featured developer, please email and let’s talk.

Frequently Asked Questions

We’ve received quite a few questions since launching the initial version of the API. Here are some frequent questions that we have been getting:

How does your API work?

It’s pretty straightforward: We provide a platform that allows the creation of ad campaigns using real-time bidding (RTB) across most ad exchanges. You can access our platform through our self-serve user interface, or through the new API for developers. If you want, for example, to build your own interface, or incorporate RTB functionality into an existing platform, you can now do so. For the comprehensive API documentation detailing how it all works, please refer to the official SiteScout API documentation.

Am I responsible for managing my users?

Yes, you will need to provide support for your own clients when building your own application, even if it’s on top of our API. It’s important to keep in mind that you are responsible for all activity that comes through your API account. If you violate our Terms Of Use, or any other policies, we will revoke your API credentials.

How does conversion tracking work? Can we use our own tracking domain?

You will need to use our conversion pixels. It would be difficult to do it otherwise. Every unique conversion action that a user creates on your system will be associated with your SiteScout RTB account, as will all campaigns. So to track a user’s conversions, you will need to associate their user ID in your system with the related campaign ID.

Do we need to sign a contract or agreement to use the SiteScout API?

Yes, you need to agree to our standard Terms Of Use when you sign up to the platform. That’s all. Then you can request API access once you have opened an account.

How do I get access to the API?

To get access to the new API, you will need to first create a SiteScout RTB account and then contact support. We will ask you to provide us with your intended use of the API (i.e., your application type), the application name, and the desired scopes of access (e.g., stats, audience, control). If you are successfully approved, you will be provided with the credentials (client ID and client secret) needed to access the API.

This is truly exciting news.

For developers looking to leverage the power of RTB advertising, there is now a solution. You don’t have to invest a fortune in infrastructure or spend years doing business development to get supply partners integrated. Simply leverage our API to power your own applications.

To learn how to get started, and stay on top of all the latest news and case studies, join our SiteScout API developer community.

{ 3 comments… read them below or add one }

Ben July 23, 2013 at 3:12 pm

Great news! You guys are doing great things there. Looking forward to dig into this.


Max July 23, 2013 at 5:28 pm



Spock July 24, 2013 at 6:58 pm


Can’t wait to get started.


Leave a Comment

Previous post:

Next post: