canonical: https://jentic.com/apis/partnerize.com/partnerize # Partnerize Partners API Jentic publishes the only available OpenAPI specification for Partnerize Partners API, keeping it validated and agent-ready. The Partnerize Partners API enables affiliate marketing management through programmatic access to campaigns, publisher relationships, commission structures, and conversion tracking. It provides 6 endpoints for retrieving campaign details, listing associated publishers, querying commission rules, pulling conversion events, and generating publisher-level performance reports. ## For AI agents Manage affiliate marketing campaigns, retrieve publisher performance data, and track conversions and commissions through the Partnerize partner network. ## Scope Does not handle ad creative management, click tracking pixels, or payment processing - use for affiliate campaign data, commissions, and publisher reporting only. ## Capabilities - Retrieve campaign details and list all active affiliate campaigns - Query publisher relationships and performance within a campaign - Access commission structures and rule configurations per campaign - Pull conversion event data for attribution and reconciliation - Generate publisher-level performance reports with revenue metrics - Filter campaign data by publisher ID for partner-specific analysis ## Use cases ### Affiliate Campaign Performance Monitoring Retrieve campaign-level and publisher-level performance data from Partnerize to monitor affiliate program health. The API returns campaign details, publisher lists, and structured reporting endpoints that break down revenue by publisher, enabling automated performance dashboards and anomaly detection across partner networks. Example prompt: Retrieve campaign details for campaign ID camp123 via `/v2/campaigns/{campaignId}`, then pull the publisher report at `/reporting/report_publisher/campaign/{campaignId}/publisher/{publisherId}` ### Conversion Tracking and Attribution Pull conversion event data from Partnerize campaigns for attribution modeling and commission reconciliation. Each conversion record includes the publisher source, transaction value, and commission amount, enabling finance teams to validate affiliate payouts and marketing teams to measure channel effectiveness against spend. Example prompt: Retrieve all conversions for campaign camp123 via GET `/v2/campaigns/{campaignId}/conversions` and calculate total attributed revenue ### Commission Structure Management Access commission rules and structures for affiliate campaigns through the Partnerize API. Each campaign defines commission tiers, performance bonuses, and payout rules that determine publisher earnings. Programmatic access enables automated auditing of commission configurations and synchronization with financial planning systems. Example prompt: Retrieve commission rules for campaign camp123 via GET `/v2/campaigns/{campaignId}/commissions` and list all active commission tiers ### AI Agent Affiliate Data Integration AI agents access Partnerize campaign and publisher data through Jentic without managing HTTP Basic Auth credentials directly. Jentic securely stores the application_key and user_key pair, letting agents query campaigns, pull conversions, or generate reports by searching for the relevant operation and executing with scoped credentials. Example prompt: Search Jentic for 'list affiliate campaign publishers', load the schema for the Partnerize publishers endpoint, and execute for campaign camp123 ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/v2/campaigns` | List all affiliate campaigns | | GET | `/v2/campaigns/{campaignId}` | Retrieve details for a specific campaign | | GET | `/v2/campaigns/{campaignId}/publishers` | List publishers in a campaign | | GET | `/v2/campaigns/{campaignId}/commissions` | Get commission rules for a campaign | | GET | `/v2/campaigns/{campaignId}/conversions` | Retrieve conversion events | | GET | `/reporting/report_publisher/campaign/{campaignId}/publisher/{publisherId}` | Generate publisher performance report | ## Key resources - **Campaigns** — List and retrieve affiliate marketing campaign details - **Publishers** — Query publishers associated with a campaign - **Commissions** — Access commission structures and rules per campaign - **Conversions** — Pull conversion events for attribution tracking - **Reporting** — Generate publisher-level performance reports ## Why Jentic - **Setup:** Wiring the Partnerize Partners API by hand means learning its basic auth with an application key and user key, setting the api.partnerize.com host, and building pagination and error handling across campaign reporting yourself. Through Jentic you install once, import the Partnerize Partners API from the API Directory, store the credentials once, and your agent calls it. - **Permission scoping:** Partnerize puts the campaign id in the URL path (`/v2/campaigns/{campaignId}/...`), so a rule can pin your agent to one campaign for reads of its publishers, commissions, and conversions. Every operation here is a GET, so nothing it can call writes or changes campaign data. - **Credential handling:** Your Partnerize application key and user key are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'track affiliate conversions on a campaign' or 'list a campaign's publishers', and Jentic returns the matching Partnerize operation with its input schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **Awin API** — Global affiliate network with publisher and advertiser management - **HubSpot Marketing Campaigns API** — Marketing automation for campaigns that feed into affiliate programs - **Mailchimp API** — Email marketing platform for nurturing affiliate audiences ## FAQ ### Why is there no official OpenAPI spec for Partnerize Partners API? Partnerize does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Partnerize Partners API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer. ### What authentication does the Partnerize Partners API use? The API uses HTTP Basic Authentication where the username is your application_key and the password is your user_key. Through Jentic, these credentials are stored encrypted in the vault and agents authenticate without exposing raw keys in their context. ### Can I pull conversion data for a specific campaign? Yes. Use GET `/v2/campaigns/{campaignId}/conversions` to retrieve all conversion events for a campaign. Each conversion record includes the publisher source, transaction value, and commission amount for attribution analysis. ### How do I generate a publisher performance report? Call GET `/reporting/report_publisher/campaign/{campaignId}/publisher/{publisherId}` with valid campaign and publisher IDs. The endpoint returns revenue metrics and performance data for the specified publisher within that campaign. ### What are the rate limits for the Partnerize Partners API? The OpenAPI spec does not document specific rate limits. Access is governed by your Partnerize account tier. Standard integrations should implement exponential backoff on 429 responses. ### How do I list all publishers in a campaign through Jentic? Search Jentic for 'list campaign publishers' to find the GET `/v2/campaigns/{campaignId}/publishers` operation. Load the schema to see required path parameters, then execute with your campaign ID. Install with pip install jentic to get started. ### Can I limit what my agent is allowed to do with the Partnerize Partners API? Yes. Because you run Jentic One yourself, your own rules decide which Partnerize operations and credentials the agent may use. Since Partnerize puts the campaign ID in the URL path, such as `/v2/campaigns/{campaignId}/publishers` or /conversions, you can pin the agent to a single campaign and restrict it to reading that campaign's publishers, commissions, and conversions. Every operation here is a GET, so the agent can retrieve campaign and reporting data without writing to or changing anything in Partnerize.