API Onboarding Process
Customers who plan to integrate with Xandr APIs need to complete the following steps in our API onboarding process.
The Xandr API endpoints are accessible only to current customers. If you're not currently a Xandr customer but are interested in becoming one, request a consultation.
Get API Access
The first step you must take to begin using the Xandr API is to contact the support team to gain access to the API endpoints. In order to be granted API access, you must meet the following criteria:
- Be a current Xandr customer with a current Console or Invest user ID and member ID. (Support cannot create a new user to fulfill a request for API access.)
- Be a Network, Network Observer, Advertiser, or Publisher user. We cannot grant API access to Network Advertiser Manager or Network Publisher Manager users. (See User Service for more on user types.)
When you open your support ticket, use the title "Request for API Access". In the body of the support ticket, include the following information:
- the numeric ID of the user that requires API access
- the billing name and numeric ID of the member under which that user exists
The support team cannot grant access to clients who are not Console or Invest users. If you are a customer with users who would like access to the API, contact the Platform Integrations team for your business unit.
After you've been granted access, you can use the following endpoints:
|Xandr API (Console and Invest)||https://api-test.appnexus.com|
Console UI has a Client Testing environment which is a full-featured copy of the production environment and is updated monthly with latest production code and data. For most use cases, it should be possible to build and test your entire integration in the client testing environment before redirecting your integration to the production environment. See Client Testing environment for more details.
Once you have built and tested your integration in the client testing environment, the final step is to point your integration at the production environment. If you have followed the API Best Practices, you should only have to update the API endpoint in your config files.
Read the Documentation
The API documentation provides insight into the structure of the API and will help you determine the best approach for integration as well as provide details on typical use cases. Read through the Reference to find information and examples for the individual services that are available to you.
API Change Info
We will notify customers of API changes. You can sign up to receive emails of API changes, as well as other Xandr news.
- If you have a Xandr user account, you should receive relevant communications automatically.
- If you do not have your own user account, you can sign up to receive communications at http://www.appnexus.com/en/subscribe.
- If you want to stop receiving marketing or other communications, you can update your preferences at http://go.appnexus.com/UnsubscribePage.html.
Complete the Self-Paced Training
We offer a pre-recorded training webinar, API Overview and Training, targeted at anyone interested in developing against our APIs. (Note, the training was recorded several years ago, but the basic concepts still apply.) The training covers the following topics:
- The reasons for using an API
- Best practices for integrating
- Definitions of breaking and non-breaking changes
- Throttling, filtering and sorting
- Data entity mapping/relationships
- JSON introduction
- API authorization
- Available tools
You should also read the API Best Practices. This document also covers many of the basic concepts that will help get you started.