Skip to main content

CJ Affiliate

CJ Affiliate (formerly Commission Junction) is an affiliate marketing network that connects advertisers with publishers. The CJ Affiliate connector reads publisher and advertiser commissions, program terms, advertiser and joined-publisher lookups, link and coupon search, product search and product feeds, and promotional properties through CJ's GraphQL and REST APIs.

CJ Affiliate icon

Power end-to-end data operations for your CJ Affiliate API with Nexla. Our bi-directional CJ Affiliate connector is purpose-built for CJ Affiliate, making it simple to ingest data, sync it across systems, and deliver it anywhere — all with no coding required. Nexla turns API-sourced data into ready-to-use, reusable data products and makes it easy to send data to CJ Affiliate or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your CJ Affiliate workflows fast, secure, and fully governed.

Features

Type: API

SourceDestination

  • Seamless API Integration: Connect to any endpoint as source or destination without coding, with automatic data product creation
  • Visual Composition & Chaining: Build complex integrations using visual templates, chain API calls, and compose workflows with data validation and filtering
  • API Proxy: Expose curated slices of your data securely with a secure and customizable API proxy that validates and transforms data on the fly
  • Request optimization with intelligent batching, retry, and caching to minimize API calls and costs

Prerequisites​

Nexla connects to the CJ Affiliate APIs with a CJ personal access token and your CJ company ID (CID). One credential works for publisher and advertiser accounts, but each template works only with one kind of account; the templates below are grouped by the account they need.

  1. You need a CJ publisher or advertiser account. Publishers can apply to join CJ; CJ reviews each application. Most templates return data only once your account has relationships with advertisers (or publishers).

  2. Sign in to the CJ Developer Portal with your CJ account, open Personal Access Tokens, and create a token. Copy the token, and store it securely.

  3. Find your company ID (CID). It is shown at the top right of CJ Account Manager.

  4. If you are a publisher and plan to use Link Search or Coupons and Promotions, you also need the ID (PID) of one of your websites or other promotional properties. Use the Promotional Properties (PIDs) template to list them.

For details, see CJ's Authentication guide.

CJ API rate limits

CJ limits API calls per account, for example 200 Commission Detail calls per 5 minutes and 25 calls per minute for the Advertiser Lookup and Link Search APIs. Templates that page through results make one request per page.

Authenticate​

Credentials required​

CJ personal access token (Bearer) plus your company ID (CID). Works for publisher and advertiser accounts; each endpoint says which account type it needs.

FieldRequiredSecretDescription
Personal Access TokenYesYesCJ personal access token from developers.cj.com > Personal Access Tokens. Sent as Authorization: Bearer <token> on every call.
Company ID (CID)YesNoYour CJ company ID (CID), shown at the top right of CJ Account Manager. Used as requestor-cid, companyId, publisherId or forPublishers/forAdvertisers.

Create a credential in Nexla​

  1. After selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

  2. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

  3. Paste your personal access token into the Personal Access Token field. Nexla sends it in the Authorization header as Bearer <token>.

    The personal access token is sensitive and should be kept secure. If it is exposed, delete it in the CJ Developer Portal, create a new token, and update this credential.

  4. Enter your CJ company ID in the Company ID (CID) field. Nexla uses it to scope every request to your account (as the requesting CID, publisher ID, or advertiser ID, depending on the API).

  5. Click the Save button at the bottom of the overlay. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation.

Nexla tests the credential by requesting your product feed count from CJ's Product API, which works for both publisher and advertiser accounts.

Use as a data source​

To create a new data flow, navigate to the Integrate section, and click the New Data Flow button. Select the CJ Affiliate connector tile, then select the credential that will be used to connect to your CJ account, and click Next; or, create a new CJ Affiliate credential for use in this flow.

Endpoint templates​

Nexla provides pre-built templates that can be used to rapidly configure data sources to ingest data from common CJ Affiliate endpoints. Select the endpoint from which this source will fetch data from the Endpoint pulldown menu. Available endpoint templates are listed in the expandable boxes below, grouped by area.

Some CJ APIs return XML (Advertiser Lookup, Link Search, and Publisher Lookup) and others return JSON from a GraphQL query; Nexla reads both, and each template's data path is already set. Templates that say "Results are paged automatically" read every page; the others make one request.

Publisher templates​

These templates need a credential for a CJ publisher account.

Publisher Commissions

Lists the commissions you earned in a posting-date window, with advertiser, action, order ID, sale amount, commission amount, validation status, and line items. Use it for earnings reporting.

  • Runs the publisherCommissions query of CJ's Commission Detail GraphQL API.
  • Results are paged automatically, up to 10,000 commissions per page, until CJ reports that the result set is complete.
  • Posted Since (required; default {now-30}): Start of the posting-date window (inclusive), as a UTC timestamp such as 2026-10-01T00:00:00Z. The window can span at most 31 days.
  • Posted Before (required; default {now}): End of the posting-date window (exclusive), as a UTC timestamp such as 2026-10-31T00:00:00Z. The window can span at most 31 days.
  • See the CJ Affiliate API reference for the response fields.

Program Terms (Contracts)

Lists your contracts with joined advertisers (active, pending, and expired) and their program terms: action trackers, commission rates, situations, item lists, and locking rules.

  • Runs the publisher.contracts query of CJ's Program Terms GraphQL API, returning up to 1,000 contracts in one request.
  • See the CJ Affiliate API reference for the response fields.

Advertiser Lookup

Lists advertisers you have joined or not joined, or the advertisers with the CIDs you enter, with relationship status, EPC, network rank, category, and default actions and commissions.

  • Calls GET /v2/advertiser-lookup?requestor-cid={company_id}&advertiser-ids={Advertisers}.
  • Results are paged automatically, 100 advertisers per page.
  • Advertisers (required; default joined): joined for advertisers you have joined, notjoined for advertisers you have not, or a comma-separated list of advertiser CIDs. Options: Joined advertisers (joined), Not-joined advertisers (notjoined).
  • See the CJ Affiliate API reference for the response fields.

Search Advertisers by Name or URL

Finds advertisers whose program name or program URL matches the text you enter, whether or not you have joined them. Use it to find an advertiser's CID.

  • Calls GET /v2/advertiser-lookup?requestor-cid={company_id}&advertiser-name={Advertiser Name or URL}.
  • Results are paged automatically, 100 advertisers per page.
  • Advertiser Name or URL (required): Program name or program URL to match, e.g. a brand name.
  • See the CJ Affiliate API reference for the response fields.

Link Search

Lists text, banner, and other links from advertisers, with tracking code, click URL, commission, and promotion dates.

  • Calls GET /v2/link-search?website-id={Website ID (PID)}&advertiser-ids={Advertisers}&keywords={Keywords}.
  • Results are paged automatically, 100 links per page.
  • Website ID (PID) (required): The ID (PID) of your website or other promotional property. CJ generates the link code for this property. Use Promotional Properties (PIDs) to find it.
  • Advertisers (required; default joined): joined for advertisers you have joined, notjoined for advertisers you have not, or a comma-separated list of advertiser CIDs. Options: Joined advertisers (joined), Not-joined advertisers (notjoined).
  • Keywords (optional): Keywords to match. Prefix a word with + to require it or - to exclude it. Leave empty to return all links.
  • See the CJ Affiliate API reference for the response fields.

Coupons and Promotions

Lists promotional links of one type, coupons by default, from advertisers, with the coupon code, promotion start and end dates, and click URL.

  • Calls GET /v2/link-search?website-id={Website ID (PID)}&advertiser-ids={Advertisers}&promotion-type={Promotion Type}.
  • Results are paged automatically, 100 links per page.
  • Website ID (PID) (required): The ID (PID) of your website or other promotional property. CJ generates the link code for this property. Use Promotional Properties (PIDs) to find it.
  • Advertisers (required; default joined): joined for advertisers you have joined, notjoined for advertisers you have not, or a comma-separated list of advertiser CIDs. Options: Joined advertisers (joined), Not-joined advertisers (notjoined).
  • Promotion Type (required; default coupon): Kind of promotion to return. Options: Coupon (coupon), Sale / discount (sale/discount), Free shipping (free shipping), Sweepstakes (sweepstakes), Product (product), Seasonal link (seasonal link), Site to store (site to store).
  • See the CJ Affiliate API reference for the response fields.

Promotional Properties (PIDs)

Lists your promotional properties (websites and other properties, each with a PID), with name, status, type, promotional models, and tags. Use it to find the PID that link and coupon search need.

  • Runs the promotionalProperties query of CJ's Promotional Properties GraphQL API, returning up to 100 properties.
  • Status (required; default ACTIVE): Property status to list. Options: Active (ACTIVE), Archived (ARCHIVED), Terminated (TERMINATED).
  • See the CJ Affiliate API reference for the response fields.

Advertiser templates​

These templates need a credential for a CJ advertiser account.

Advertiser Commissions

Lists the commissions your program paid to publishers in a posting-date window, with publisher, action, order ID, sale amount, publisher commission, and CJ fee.

  • Runs the advertiserCommissions query of CJ's Commission Detail GraphQL API.
  • Results are paged automatically, up to 10,000 commissions per page, until CJ reports that the result set is complete.
  • Posted Since (required; default {now-30}): Start of the posting-date window (inclusive), as a UTC timestamp such as 2026-10-01T00:00:00Z. The window can span at most 31 days.
  • Posted Before (required; default {now}): End of the posting-date window (exclusive), as a UTC timestamp such as 2026-10-31T00:00:00Z. The window can span at most 31 days.
  • See the CJ Affiliate API reference for the response fields.

Joined Publishers by Country

Lists the publishers joined to your program in one country, with their websites (PIDs), categories, promotional methods, EPC, and program terms.

  • Calls GET /v2/joined-publisher-lookup?requestor-cid={company_id}&country={Country}.
  • Results are paged automatically, 25 publishers per page.
  • Country (required; default US): The two-letter ISO 3166-1 country code of the publishers, for example US, GB, or DE.
  • See the CJ Affiliate API reference for the response fields.

Joined Publisher by CID

Returns one publisher joined to your program, by its company ID (CID), with websites, categories, promotional methods, EPC, and program terms history.

  • Calls GET /v2/joined-publisher-lookup?requestor-cid={company_id}&cid={Publisher CID}.
  • Publisher CID (required): The CID of a publisher joined to your program. Use Joined Publishers by Country, or the publisherId from Advertiser Commissions, to find it.
  • See the CJ Affiliate API reference for the response fields.

Publisher and advertiser templates​

These templates work with either kind of account.

Product Search

Finds products in advertisers' product feeds that match your keywords, with title, brand, price, sale price, link, image, and advertiser.

  • Runs the products query of CJ's Product GraphQL API and returns the top 1,000 matches in one request.
  • Keywords (required): Words to search for in product names, descriptions, and brands.
  • Advertiser Relationship (required; default JOINED): For publisher accounts, whether to search the feeds of advertisers you have joined or not joined. Advertiser accounts ignore this setting. Options: Joined (JOINED), Not joined (NOT_JOINED).
  • See the CJ Affiliate API reference for the response fields.

Product Feeds

Lists product feeds with their ad ID, name, advertiser, country, currency, language, product count, and last update time. Publisher accounts see feeds from joined and non-joined advertisers.

  • Runs the productFeeds query of CJ's Product GraphQL API in one request.
  • See the CJ Affiliate API reference for the response fields.

Once the selected endpoint template has been configured, click the Test button to the right of the endpoint selection menu to retrieve a sample of the data that will be fetched. Sample data will be displayed in the Endpoint Test Result panel on the right, allowing you to verify that the source is configured correctly before saving.

Manual configuration​

CJ Affiliate data sources can also be manually configured to ingest data from any valid CJ Affiliate API endpoint, including endpoints not covered by the pre-built templates, chained API calls, or custom request parameters. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, endpoint URL, date/time and lookup macros, path to data, metadata, and request headers.

Once all of the relevant settings have been configured, click the Create button in the upper right corner of the screen to save and create the new CJ Affiliate data source. Nexla will now begin ingesting data from the configured endpoint and will organize any data that it finds into one or more Nexsets.