Native Publisher API

The Native Publisher API allows you to manage publisher-related entities. The API provides you with a set of RESTful objects that you can use to programmatically create and manage multiple sites with multiple placements on those sites.

Using these RESTful objects, you can access HTTP resources, which return a set of JSON representations along with their corresponding data types.

If you are new to the API, you may wish to review the sections below that discuss key terms, example endpoints and operations.

Publisher Account

Native publishers are managed by the Verizon Media Publisher Sales and Business Development team. As a publisher, you’ll need to obtain an account ID from your account manager.

For example:

XYZ News (Test) publisher account ID: 131231

Once you obtain a publisher account ID, you can use the API service to create multiple sites. For each site, you can create multiple placements.

Important

Before you start working with the API, ensure that you understand the hierarchy of objects, as shown below.

Object Hierarchy

publisher object hierarchy

Key Terminology

A resource is an essential data abstraction in the RESTful software architecture. A resource can be any named object, service or collection of other resources. The Verizon Media RESTful API relies on a resource identifier to identify a resource used when defining the interaction between objects.

An endpoint is a URI (Uniform Resource Identifier) that provides access to a resource. Endpoints define how you access the resource. Supported HTTP methods specify which interactions, like GET, POST, PUT or DELETE, are permitted with the resource.

A service is comprised of an endpoint, an HTTP method and a set of parameters.

Site(s) refer to website(s) or mobile app(s). Sites are used to register websites and mobile apps in the system.

Get Started

To get started, you’ll need to apply for access and an API Key. The process is simple and straightforward.

Follow these steps:

  1. Begin by filling out the form at Apply for Access.

  2. Once you complete the form, you’ll need to create an app and obtain an API key and secret.

  3. See the section on Authentication for details on how to Create an app and obtain an API key.

  4. Once you have an API key and secret, explore the section below on how to Navigate the Native Publisher API.