Publisher Lookup

Overview

Advertisers can use the Publisher Lookup API to easily and automatically look up information about the publishers in their programs. For example you could use this API to quickly access a list of which publishers are joined to what program terms.

Advertisers can use this REST API to search for publishers within their program by a variety of criteria, for example by country or relationship status, and then view the details about those publishers, including program name, websites and PIDs, categories and promotional methods used, as well as other information related to the publisher's account.

NOTE: The request URI for the Publisher Lookup API must be properly encoded based on HTML 4 specification form content encoding rules. Please refer to http://www.w3.org/TR/REC-html40/interact/forms.html#h-17.13.4 for the standard specification.

Limits

Call limit: 25 calls per minute
Call restrictions: Advertisers only

Request

GET https<no-link>://publisher-lookup.api.cj.com/v2/joined-publisher-lookup

Sample Request

This URL would be used to view all of your publishers who are located in the United States. Use the criteria below to customize a URL for your needs. See the Authentication Overview for information on how to authenticate API calls.

curl -s XGET "https://publisher-lookup.api.cj.com/v2/joined-publisher-lookup?requestor-cid=4567&country=US" -H "Authorization: Bearer <your-personal-access-token>"

Request Parameters

Refer to the following table for a list of request parameters. All parameter names and values are case-insensitive. Submitting an empty request does not return all possible results; an empty request returns zero results.

Response

Sample Response

Refer to the following sample XML response.

<cj-api>
  <publishers page-number="1" records-returned="2" total-matched="2">
    <publisher>
      <cid>1070179</cid>
      <country>US</country>
      <currency>USD</currency>
      <network-rating>0</network-rating>
      <publisher-name>MH Retailers</publisher-name>
      <program-terms>
        <name>CJ Demo</name>
        <date-accepted>03/28/2011 10:03:59 PDT</date-accepted>
        <date-expired/>
        <join-status>active</join-status>
      </program-terms>
      <program-terms>
        <name>CJ Demo 2</name>
        <date-accepted>03/28/2011 09:35:36 PDT</date-accepted>
        <date-expired>03/28/2011 09:44:42 PDT</date-expired>
        <join-status>cancelled</join-status>
      </program-terms>
      <promotional-methods>
        <promotional-method>Web site / Content</promotional-method>
        <promotional-method>Software</promotional-method>
      </promotional-methods>
      <seven-day-epc>N/A</seven-day-epc>
      <three-month-epc>N/A</three-month-epc>
      <websites>
        <website>
          <name>Web Site</name>
          <pid>2115358</pid>
          <url>http://www.cj.com</url>;
          <category>Virtual Malls</category>
        </website>
        <website>
          <name>CJ Pay Per Call</name>
          <pid>468534</pid>
          <url>http://www.cj.com</url>
          <category>Marketing</category>
        </website>
      </websites>
    </publisher>
  </publishers>
</cj-api>

Response Elements

The following response fields get returned in XML for joined publishers that meet the request parameters.

Errors

REST Errors For All APIs

The HTTP Response Code for the following errors is 401.

Publisher Lookup Errors

The HTTP Response Code for the following errors is 400.