Skip to main content

How to use API Access

API access to your own Publisher Champ account is included with Champ Ultra and during the standard 14-day free trial. View Ultra pricing.

Already using two accounts for API access?

If you currently have a main Publisher Champ account and a separate account for your API integration, please email our team or contact us through live chat. Your existing two-account API setup will continue to work as before until you ask us to transition it to the Ultra plan. We will then help you move the integration to a single account.

This guide explains how to:

  1. Find your API credentials
  2. Access your own account by API
  3. Grant API access to another Publisher Champ user
  4. Revoke API access later if needed

You can find this page in Publisher Champ at My Account > Settings > API Access.

Before you start

To use the API with your own account, use the standard 14-day free trial or activate a paid Champ Ultra subscription. Existing users with an approved Enterprise API or legacy arrangement retain their approved access.

Where to find API Access

  1. Log in to Publisher Champ
  2. Go to My Account Settings
  3. Open the API Access tab

Access your own account

  1. Use the standard 14-day free trial or activate a paid Champ Ultra subscription.
  2. Open My Account → Settings → API Access.
  3. Copy your api_key and your own account_id.
  4. Use Accounts → List accounts in the API documentation to see the accounts currently available to your key.

The standard 14-day free trial includes API and MCP access to your own account. It does not enable sharing API access with other users.

Grant API access to another user

Use this when you want another Publisher Champ user to access your account by API.

  1. Open the API Access tab
  2. In Share Your Account By API, enter the recipient's email address
  3. Click Grant Access
  4. Confirm the action

After this:

  • The other user can use their own API key
  • They can use your account_id
  • Your account will appear in their available account list only while the commercial access requirements remain satisfied
note

The receiving user must already have an API key. In addition, either:

  • The account owner sharing access must have an active paid Ultra subscription, or
  • The receiving API user must have an approved Enterprise API or legacy arrangement

The API returns only accounts that currently satisfy these rules.

Revoke API access

You can remove API access at any time.

  1. Open the API Access tab
  2. In Who Has Access, find the email address
  3. Click Revoke
  4. Confirm the action

Once revoked, that user will no longer have explicit API access to your account.

If the account owner downgrades from Ultra or the subscription expires, the granted account also stops being returned unless the receiving API user has an approved Enterprise API or legacy arrangement.

What the other user sees

If the receiving user has an active API key, they will see:

  • Their assigned api_key
  • The account_id values they can use

They can then call the API with:

  • Their own api_key
  • The granted account's account_id

Summary

  • Ultra and the standard 14-day free trial include API access to your own account
  • Use the API Access tab to grant access by email
  • Use the same tab to revoke access later
  • Sharing requires a paid Ultra account owner unless the recipient has an approved Enterprise API or legacy arrangement
  • Only currently eligible accounts are returned by the API

For an Enterprise API arrangement, contact us through live chat or email support@publisherchamp.com.