Affiliate programs, deals, tracked links and product search, plus merchant program setup tools.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Clickwise API key, optional. Program discovery, deals, catalog stats and tracked links work without it. Product search and GTIN lookup work with a free 14-day sandbox key that needs no account, from the Developers page (websiteUrl). Feeds, your links and reports need your publisher key.
Merchant Bearer token, optional. Only the merchant tools that say "Merchant Bearer token required" use it: tracking test link, conversions key, integration status and results. The account gets it once, from get_merchant_credentials.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Answer the application question. An agent calls this at a person's request.
True only when the person has read the Clickwise merchant terms and told the agent they accept them. The agent never accepts on its own. Send it with terms_version.
Promotion channels prohibited by the merchant for all publishers. An explicit empty list declares no additional prohibitions.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Tool list last changed Oct 23, 2026.
Answer the application question. An agent calls this at a person's request.
| Argument | Type | Description |
|---|---|---|
| lang | string | |
| message | string | |
| access_secret* | string | |
| terms_version | string | |
| application_id* | integer | |
| terms_accepted | boolean | True only when the person has read the Clickwise merchant terms and told the agent they accept them. The agent never accepts on its own. Send it with terms_version. |
| channel_restrictions | array | Promotion channels prohibited by the merchant for all publishers. An explicit empty list declares no additional prohibitions. |
{
"type": "object",
"required": [
"application_id",
"access_secret"
],
"properties": {
"lang": {
"type": "string"
},
"message": {
"type": "string"
},
"access_secret": {
"type": "string"
},
"terms_version": {
"type": "string"
},
"application_id": {
"type": "integer",
"minimum": 1
},
"terms_accepted": {
"type": "boolean",
"description": "True only when the person has read the Clickwise merchant terms and told the agent they accept them. The agent never accepts on its own. Send it with terms_version."
},
"channel_restrictions": {
"type": "array",
"items": {
"enum": [
"shopping_css",
"paid_search",
"brand_bidding",
"direct_linking",
"feed_access",
"redistribution",
"organic_content",
"social",
"email",
"coupon",
"cashback",
"display_ads",
"retargeting",
"post_view",
"creative_assets",
"creative_derivatives"
],
"type": "string"
},
"description": "Promotion channels prohibited by the merchant for all publishers. An explicit empty list declares no additional prohibitions."
}
}
}Ask to join a program (program_id from list_my_programs with include_available, or a campaign_id). Clickwise reviews the fit; the result is approved or pending. Requires your own Clickwise affiliate API key on the MCP connection (X-API-Key header or Authorization: Bearer); acts only on your account.
| Argument | Type | Description |
|---|---|---|
| program_id | integer | |
| campaign_id | string | integer |
{
"type": "object",
"properties": {
"program_id": {
"type": "integer"
},
"campaign_id": {
"type": [
"string",
"integer"
]
}
},
"additionalProperties": false
}Create a program for its first payment. An agent calls this at a person's request. Default commission 25%, percent range 10–50%; recurring_months: 0 only. No setup fee; you pay on approved sales. The agent never accepts the Clickwise merchant terms on its own: send terms_accepted with terms_version only after the person has read the merchant terms page and told you they accept them. Otherwise leave it out: the program is not set up until the person accepts them and you send terms_accepted with terms_version, here or later in POST /api/v1/onboarding/merchant/{application_id}/ with the access_secret (required action confirm_terms).
| Argument | Type | Description |
|---|---|---|
| lang | string | |
| country | string | |
| message | string | |
| website | string | |
| vertical | string | |
| commission | object | |
| cookie_days | integer | |
| company_name | string | |
| product_type | string | |
Use this when you already have a Clickwise affiliate API key and want tracking links for programs you are approved in: one per item (the same program and subid return the same link), optionally deep-linking to a landing_url on the merchant's site. Each item reports its own status; a failed item never blocks the others. Without an account use request_tracked_links. Requires your own Clickwise affiliate API key on the MCP connection (X-API-Key header or Authorization: Bearer); acts only on your account.
| Argument | Type | Description |
|---|---|---|
| links* | array |
{
"type": "object",
"required": [
"links"
],
"properties": {
"links": {
"type": "array",
"items": {
"type": "object",
"properties": {
"subid": {
"type": "string",
"maxLength": 100,
"description": "Your placement/sub ID."
},
"program_id": {
"type": "integer",
"description": "Alternative to campaign_id."
},
"campaign_id": {
"type": [
"string",
"integer"
],
"description": "From list_my_programs."
},
"landing_url": {
"type": "string",
"maxLength": 2000,
"description": "Deep link target on the merchant's own domain."
}
},
"additionalProperties": false
},
"maxItems": 20,
"minItems": 1
}
},
"additionalProperties": false
}Use this first when someone without a Clickwise account asks which merchants to promote: it ranks live programs by fit for a described site, app, newsletter or social channel. Does not require signup. For the whole catalogue page by page use list_programs; for the programs your API key is already approved in use list_my_programs.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| topic | string | Audience or content topic, e.g. travel deals, AI shopping assistant, sneakers. |
| channel | string | Publishing channel: site, app, newsletter, Instagram, TikTok, coupon, cashback, etc. |
| country | string | Main audience country, ISO 3166-1 alpha-2 if known. |
| network | string | Optional source network slug; applies only to signed-in affiliates. |
| category | string | Preferred vertical/category. |
| merchant | string | Optional merchant name/domain filter. |
| publisher_url | string | Where the affiliate will publish: URL, app URL, social profile, newsletter page, etc. |
Public GTIN catalog counts as of generated_at, using the same stored snapshot as /api/v1/public/catalog-stats/. Fixed one-hour validity; snapshot_stale marks older counts, served for up to 7 days. No affiliate data or amounts.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Your own native Clickwise redirect clicks for an inclusive date range. Returns individual clicks and total, excluding bots by default; upstream network clicks are not included. The REST resource has no grouping. Requires your own Clickwise affiliate API key on the MCP connection (X-API-Key header or Authorization: Bearer); acts only on your account.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| sub_id | string | |
| date_to | string | YYYY-MM-DD |
| date_from | string | YYYY-MM-DD |
| page_size | integer | |
| campaign_id | string | |
| deeplink_id | string |
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"default": 1,
"minimum": 1
},
"sub_id": {
"type": "string"
},
"date_to": {
"type": "string",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
"description": "YYYY-MM-DD"
},
"date_from": {
"type": "string",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
"description": "YYYY-MM-DD"
},
"page_size": {
"type": "integer",
"default": 50,
"maximum": 200,
"minimum": 1
},
"campaign_id": {
"type": "string"
},
"deeplink_id": {
"type": "string"
}
},
"additionalProperties": false
}Reveal a new conversions key once, or rotate with rotate=true. An agent calls this at a person's request. Merchant Bearer token required.
| Argument | Type | Description |
|---|---|---|
| rotate | boolean |
{
"type": "object",
"required": [],
"properties": {
"rotate": {
"type": "boolean"
}
}
}Fetch the full record for a single deal by its slug. Returns title, description, code, discount, target_url, etc., in the requested language.
| Argument | Type | Description |
|---|---|---|
| lang | string | |
| slug* | string |
{
"type": "object",
"required": [
"slug"
],
"properties": {
"lang": {
"enum": [
"en",
"es",
"pt",
"fr",
"de",
"it"
],
"type": "string",
"default": "en"
},
"slug": {
"type": "string"
}
}
}Read authenticated test-sale evidence and the last real sale. Merchant Bearer token required.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}get_merchant_credentials: Returns a merchant API token only if the account has none yet. If one exists, it answers 409 and explains where the account holder can copy it. It never reveals an existing token.
| Argument | Type | Description |
|---|---|---|
| access_secret* | string | |
| application_id* | integer |
{
"type": "object",
"required": [
"application_id",
"access_secret"
],
"properties": {
"access_secret": {
"type": "string"
},
"application_id": {
"type": "integer",
"minimum": 1
}
}
}Use this when a publisher without an account wants links ready to render on a site or app: it creates a provisional Clickwise affiliate and tracked links, as request_tracked_links does, and also returns cards, an HTML embed snippet and a JSON feed. Email is optional; the account is claimed later for payout. For plain links use request_tracked_links; with an existing API key use create_tracking_links.
| Argument | Type | Description |
|---|---|---|
| limit | integer | How many cards to return. |
| topic | string | Audience/content topic, e.g. travel deals, AI shopping assistant, sneakers. |
| sub_id | string | Optional placement/sub ID for attribution. |
| country | string | Main audience country, ISO 3166-1 alpha-2. |
| category | string | Preferred vertical/category. |
| claim_email | string | Optional email to claim the account (and payout) later. |
| program_ids | array | Optional specific program IDs; omit to let Clickwise pick fitting merchants. |
| publisher_url | string | The app/site/profile where the feed will be embedded. |
Fetch the full record for a single news article by its slug.
| Argument | Type | Description |
|---|---|---|
| lang | string | |
| slug* | string |
{
"type": "object",
"required": [
"slug"
],
"properties": {
"lang": {
"enum": [
"en",
"es",
"pt",
"fr",
"de",
"it"
],
"type": "string",
"default": "en"
},
"slug": {
"type": "string"
}
}
}Use this when an affiliate asks when they get paid: approved commission not yet paid (per currency and in USD), commission still pending review, the next payment as an estimate with its threshold, and the payment method as its type (a bank account shows only its last 4 digits). Read-only; never returns account numbers, PayPal addresses, postal or tax data. Requires your own Clickwise affiliate API key on the MCP connection (X-API-Key header or Authorization: Bearer); acts only on your account.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Your conversions and commission (what you earn), grouped by day, week, month, subid, campaign or status, for up to 366 days (default: last 30). Daily/weekly/monthly series include empty periods. Requires your own Clickwise affiliate API key on the MCP connection (X-API-Key header or Authorization: Bearer); acts only on your account.
| Argument | Type | Description |
|---|---|---|
| subid | string | |
| status | string | |
| date_to | string | YYYY-MM-DD |
| group_by | string | |
| date_from | string | YYYY-MM-DD |
{
"type": "object",
"properties": {
"subid": {
"type": "string",
"maxLength": 100
},
"status": {
"enum": [
"pending",
"approved",
"declined"
],
"type": "string"
},
"date_to": {
"type": "string",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
"description": "YYYY-MM-DD"
},
"group_by": {
"enum": [
"day",
"week",
"month",
"subid",
"campaign",
"status"
],
"type": "string",
"default": "day"
},
"date_from": {
"type": "string",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
"description": "YYYY-MM-DD"
}
},
"additionalProperties": false
}Create or refresh a GTIN product feed for your authenticated affiliate and one country, and return its signed URL (json, csv, tsv or xml) with Clickwise /dl/ tracked product links. The same request returns the same URL. Requires your affiliate API key. Current freshness, permissions, assignments and delivery caps apply.
| Argument | Type | Description |
|---|---|---|
| format | string | |
| country* | string | |
| category | string |
{
"type": "object",
"required": [
"country"
],
"properties": {
"format": {
"enum": [
"json",
"csv",
"tsv",
"xml"
],
"type": "string",
"default": "json"
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$"
},
"category": {
"type": "string",
"maxLength": 200
}
},
"additionalProperties": false
}Read the application and pending question using application_id and access_secret.
| Argument | Type | Description |
|---|---|---|
| access_secret* | string | |
| application_id* | integer |
{
"type": "object",
"required": [
"application_id",
"access_secret"
],
"properties": {
"access_secret": {
"type": "string"
},
"application_id": {
"type": "integer",
"minimum": 1
}
}
}Read native direct program clicks, pending, approved and rejected conversions, commission by currency and billing status. Merchant Bearer token required.
| Argument | Type | Description |
|---|---|---|
| days | integer | |
| group_by | string |
{
"type": "object",
"required": [],
"properties": {
"days": {
"type": "integer",
"maximum": 365,
"minimum": 1
},
"group_by": {
"enum": [
"day",
"week"
],
"type": "string"
}
}
}Fetch a link request, affiliate RefId, review status, and issued links using its access secret.
| Argument | Type | Description |
|---|---|---|
| access_secret* | string | |
| application_id* | integer |
{
"type": "object",
"required": [
"application_id",
"access_secret"
],
"properties": {
"access_secret": {
"type": "string"
},
"application_id": {
"type": "integer"
}
}
}Issue a nonpayable house probe link, integration steps and a prompt for Lovable, Bolt or v0. An agent calls this at a person's request. Merchant Bearer token required.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Your individual conversions (default: last 90 days) with status, commission, currency and subid, plus a per-subid rollup. Requires your own Clickwise affiliate API key on the MCP connection (X-API-Key header or Authorization: Bearer); acts only on your account.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| subid | string | |
| status | string | |
| date_to | string | YYYY-MM-DD |
| date_from | string | YYYY-MM-DD |
| page_size | integer |
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"default": 1,
"minimum": 1
},
"subid": {
"type": "string",
"maxLength": 100
},
"status": {
"enum": [
"pending",
"approved",
"declined"
],
"type": "string"
},
"date_to": {
"type": "string",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
"description": "YYYY-MM-DD"
},
"date_from": {
"type": "string",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
"description": "YYYY-MM-DD"
},
"page_size": {
"type": "integer",
"default": 100,
"maximum": 500,
"minimum": 1
}
},
"additionalProperties": false
}List active Clickwise deals and offers, optionally filtered by language, category, country or merchant.
| Argument | Type | Description |
|---|---|---|
| lang | string | |
| limit | integer | |
| country | string | ISO 3166-1 alpha-2 (US, ES, BR, ...) |
| network | string | Optional source network slug; applies only to signed-in affiliates. |
| category | string | e.g. fashion, travel, electronics, health |
| merchant | string | Merchant name or domain |
{
"type": "object",
"properties": {
"lang": {
"enum": [
"en",
"es",
"pt",
"fr",
"de",
"it"
],
"type": "string",
"default": "en"
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
},
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-2 (US, ES, BR, ...)"
},
"network": {
"type": "string",
"description": "Optional source network slug; applies only to signed-in affiliates."
},
"category": {
"type": "string",
"description": "e.g. fashion, travel, electronics, health"
},
"merchant": {
"type": "string",
"description": "Merchant name or domain"
}
}
}Use this when you hold a Clickwise affiliate API key and need the programs that key is approved to promote, with link readiness and your existing link count; set include_available to add the ones you can apply to. For discovery without an account use find_affiliate_programs or list_programs. Requires your own Clickwise affiliate API key on the MCP connection (X-API-Key header or Authorization: Bearer); acts only on your account.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| search | string | Merchant/campaign name filter. |
| page_size | integer | |
| include_available | boolean |
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"default": 1,
"minimum": 1
},
"search": {
"type": "string",
"maxLength": 200,
"description": "Merchant/campaign name filter."
},
"page_size": {
"type": "integer",
"default": 50,
"maximum": 200,
"minimum": 1
},
"include_available": {
"type": "boolean",
"default": false
}
},
"additionalProperties": false
}List Clickwise news announcements about affiliate programs (policy changes, launches, shutdowns, commission updates).
| Argument | Type | Description |
|---|---|---|
| lang | string | |
| limit | integer | |
| network | string | |
| severity | string |
{
"type": "object",
"properties": {
"lang": {
"enum": [
"en",
"es",
"pt",
"fr",
"de",
"it"
],
"type": "string",
"default": "en"
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
},
"network": {
"type": "string"
},
"severity": {
"enum": [
"info",
"warn",
"critical"
],
"type": "string"
}
}
}Use this to browse the whole live catalogue page by page, filtered by merchant, category or country, when find_affiliate_programs' ranked top matches are not enough. No key needed; it shows programs anyone can join. For the programs your API key is approved in use list_my_programs.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| country | string | ISO 3166-1 alpha-2 |
| network | string | Optional source network slug; applies only to signed-in affiliates. |
| category | string | |
| merchant | string | Merchant name or domain |
| page_size | integer | |
| ready_only | boolean | Only programs that can issue a tracked link right now. |
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"default": 1,
"minimum": 1
},
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-2"
},
"network": {
"type": "string",
"description": "Optional source network slug; applies only to signed-in affiliates."
},
"category": {
"type": "string"
},
"merchant": {
"type": "string",
"description": "Merchant name or domain"
},
"page_size": {
"type": "integer",
"default": 24,
"maximum": 60,
"minimum": 1
},
"ready_only": {
"type": "boolean",
"default": true,
"description": "Only programs that can issue a tracked link right now."
}
}
}Alias of create_program. Create a program for its first payment. An agent calls this at a person's request. Default commission 25%, percent range 10–50%; recurring_months: 0 only. No setup fee; you pay on approved sales. The agent never accepts the Clickwise merchant terms on its own: send terms_accepted with terms_version only after the person has read the merchant terms page and told you they accept them. Otherwise leave it out: the program is not set up until the person accepts them and you send terms_accepted with terms_version, here or later in POST /api/v1/onboarding/merchant/{application_id}/ with the access_secret (required action confirm_terms).
| Argument | Type | Description |
|---|---|---|
| lang | string | |
| country | string | |
| message | string | |
| website | string | |
| vertical | string | |
| commission | object | |
| cookie_days | integer | |
| company_name | string | |
| product_type | string |
Use this when you have no Clickwise account yet and want tracked links: it creates a provisional affiliate and returns links for the programs that can issue one to it. Email is optional; the account is claimed and payout details are added later (update_profile). With an API key use create_tracking_links; for ready-made cards and an embed use get_monetization_feed.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| topic | string | |
| sub_id | string | Optional placement/sub ID for attribution. |
| channel | string | |
| country | string | |
| category | string | |
| claim_email | string | Optional email to claim the account later; not required to get links. |
| program_ids | array | Program IDs returned by find_affiliate_programs. If omitted, Clickwise picks fitting programs. |
| publisher_url | string | Where the affiliate will publish. URL/profile/app is strongly recommended. |
Search fresh GTIN products in the catalog your affiliate can deliver (freshness, permissions and caps apply). Requires your affiliate API key in X-API-Key or Bearer authorization; a sandbox key (cw_sbx_, free at partners.clickwise.net/developers) also works; sandbox links are examples and do not track clicks or earn commission. Every key gets exactly the REST GET /api/v1/publisher/products/ format (with gtin: /products/lookup/): products with id, gtin, title, price and currency, url (a Clickwise /dl/ tracked link created for your affiliate the first time a product is returned), image, merchant (id, name and its public website domain), availability, country, brand, category, regular_price, description, size, color and group_id (shared by the sizes of one model and colour), plus count, total and total_exact. Search by text, brand or category, or list one market by country alone; min_price and max_price filter by price in each product's own currency (inclusive, no conversion) and currency keeps one currency; with gtin every market carrying that GTIN is searched; offset paginates.
| Argument | Type | Description |
|---|---|---|
| gtin | string | |
| text | string | |
| brand | string | |
| limit | integer | |
| subid | string | Your own sub-ID for these links (up to 36 characters: letters, digits, _ or -; no personal data). A sale made through one of them reports it in your conversions. |
| offset | integer | |
Update a creator's monetization profile (claim email, display name, website, country, payment method) using the application_id + access_secret returned by request_tracked_links. Overwrites the fields provided. Lets a creator's assistant complete claim/payout details without leaving chat.
| Argument | Type | Description |
|---|---|---|
| country | string | |
| claim_email | string | |
| website_url | string | |
| display_name | string | |
| access_secret* | string | |
| application_id* | integer | |
| payment_method | object | e.g. {"Type": "Paypal", "Paypal_ID": "[email protected]", "Paypal_Name": "Your Name"} |
{
"type": "object",
"required": [
"application_id",
"access_secret"
],
"properties": {
"country": {
"type": "string"
},
"claim_email": {
"type": "string"
},
"website_url": {
"type": "string"
},
"display_name": {
"type": "string"
},
"access_secret": {
"type": "string"
},
"application_id": {
"type": "integer"
},
"payment_method": {
"type": "object",
"description": "e.g. {\"Type\": \"Paypal\", \"Paypal_ID\": \"[email protected]\", \"Paypal_Name\": \"Your Name\"}"
}
}
}| contact_email |
| string |
| networks_used | array |
| pricing_model | string |
| terms_version | string |
| terms_accepted | boolean | True only when the person has read the Clickwise merchant terms and told the agent they accept them. The agent never accepts on its own. Send it with terms_version. |
| payment_provider | string |
| privacy_policy_url | string |
| channel_restrictions | array | Promotion channels prohibited by the merchant for all publishers. An explicit empty list declares no additional prohibitions. |
{
"type": "object",
"required": [],
"properties": {
"lang": {
"type": "string"
},
"country": {
"type": "string"
},
"message": {
"type": "string"
},
"website": {
"type": "string"
},
"vertical": {
"type": "string"
},
"commission": {
"type": "object",
"properties": {
"type": {
"enum": [
"percent",
"fixed"
],
"type": "string"
},
"value": {
"type": "number"
},
"recurring_months": {
"enum": [
0
],
"type": "integer",
"description": "0 only"
}
}
},
"cookie_days": {
"type": "integer",
"maximum": 365,
"minimum": 1
},
"company_name": {
"type": "string"
},
"product_type": {
"enum": [
"web_saas",
"web_app",
"mobile_app",
"extension",
"other"
],
"type": "string"
},
"contact_email": {
"type": "string"
},
"networks_used": {
"type": "array"
},
"pricing_model": {
"enum": [
"one_time",
"subscription"
],
"type": "string"
},
"terms_version": {
"type": "string"
},
"terms_accepted": {
"type": "boolean",
"description": "True only when the person has read the Clickwise merchant terms and told the agent they accept them. The agent never accepts on its own. Send it with terms_version."
},
"payment_provider": {
"enum": [
"stripe",
"lemonsqueezy",
"paddle",
"revenuecat",
"shopify",
"woocommerce",
"other"
],
"type": "string"
},
"privacy_policy_url": {
"type": "string"
},
"channel_restrictions": {
"type": "array",
"items": {
"enum": [
"shopping_css",
"paid_search",
"brand_bidding",
"direct_linking",
"feed_access",
"redistribution",
"organic_content",
"social",
"email",
"coupon",
"cashback",
"display_ads",
"retargeting",
"post_view",
"creative_assets",
"creative_derivatives"
],
"type": "string"
},
"description": "Promotion channels prohibited by the merchant for all publishers. An explicit empty list declares no additional prohibitions."
}
}
}| traffic_daily | integer | Estimated daily visits/reach. |
| include_unready | boolean | Also return published matched programs whose links are not available yet; can_issue_link_now indicates availability. |
| traffic_monthly | integer | Estimated monthly visits/reach. |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 8,
"maximum": 20,
"minimum": 1
},
"topic": {
"type": "string",
"description": "Audience or content topic, e.g. travel deals, AI shopping assistant, sneakers."
},
"channel": {
"type": "string",
"description": "Publishing channel: site, app, newsletter, Instagram, TikTok, coupon, cashback, etc."
},
"country": {
"type": "string",
"description": "Main audience country, ISO 3166-1 alpha-2 if known."
},
"network": {
"type": "string",
"description": "Optional source network slug; applies only to signed-in affiliates."
},
"category": {
"type": "string",
"description": "Preferred vertical/category."
},
"merchant": {
"type": "string",
"description": "Optional merchant name/domain filter."
},
"publisher_url": {
"type": "string",
"description": "Where the affiliate will publish: URL, app URL, social profile, newsletter page, etc."
},
"traffic_daily": {
"type": "integer",
"description": "Estimated daily visits/reach."
},
"include_unready": {
"type": "boolean",
"default": false,
"description": "Also return published matched programs whose links are not available yet; can_issue_link_now indicates availability."
},
"traffic_monthly": {
"type": "integer",
"description": "Estimated monthly visits/reach."
}
}
}{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 5,
"maximum": 10,
"minimum": 1,
"description": "How many cards to return."
},
"topic": {
"type": "string",
"description": "Audience/content topic, e.g. travel deals, AI shopping assistant, sneakers."
},
"sub_id": {
"type": "string",
"description": "Optional placement/sub ID for attribution."
},
"country": {
"type": "string",
"description": "Main audience country, ISO 3166-1 alpha-2."
},
"category": {
"type": "string",
"description": "Preferred vertical/category."
},
"claim_email": {
"type": "string",
"description": "Optional email to claim the account (and payout) later."
},
"program_ids": {
"type": "array",
"items": {
"type": "integer"
},
"description": "Optional specific program IDs; omit to let Clickwise pick fitting merchants."
},
"publisher_url": {
"type": "string",
"description": "The app/site/profile where the feed will be embedded."
}
}
}| contact_email | string |
| networks_used | array |
| pricing_model | string |
| terms_version | string |
| terms_accepted | boolean | True only when the person has read the Clickwise merchant terms and told the agent they accept them. The agent never accepts on its own. Send it with terms_version. |
| payment_provider | string |
| privacy_policy_url | string |
| channel_restrictions | array | Promotion channels prohibited by the merchant for all publishers. An explicit empty list declares no additional prohibitions. |
{
"type": "object",
"required": [],
"properties": {
"lang": {
"type": "string"
},
"country": {
"type": "string"
},
"message": {
"type": "string"
},
"website": {
"type": "string"
},
"vertical": {
"type": "string"
},
"commission": {
"type": "object",
"properties": {
"type": {
"enum": [
"percent",
"fixed"
],
"type": "string"
},
"value": {
"type": "number"
},
"recurring_months": {
"enum": [
0
],
"type": "integer",
"description": "0 only"
}
}
},
"cookie_days": {
"type": "integer",
"maximum": 365,
"minimum": 1
},
"company_name": {
"type": "string"
},
"product_type": {
"enum": [
"web_saas",
"web_app",
"mobile_app",
"extension",
"other"
],
"type": "string"
},
"contact_email": {
"type": "string"
},
"networks_used": {
"type": "array"
},
"pricing_model": {
"enum": [
"one_time",
"subscription"
],
"type": "string"
},
"terms_version": {
"type": "string"
},
"terms_accepted": {
"type": "boolean",
"description": "True only when the person has read the Clickwise merchant terms and told the agent they accept them. The agent never accepts on its own. Send it with terms_version."
},
"payment_provider": {
"enum": [
"stripe",
"lemonsqueezy",
"paddle",
"revenuecat",
"shopify",
"woocommerce",
"other"
],
"type": "string"
},
"privacy_policy_url": {
"type": "string"
},
"channel_restrictions": {
"type": "array",
"items": {
"enum": [
"shopping_css",
"paid_search",
"brand_bidding",
"direct_linking",
"feed_access",
"redistribution",
"organic_content",
"social",
"email",
"coupon",
"cashback",
"display_ads",
"retargeting",
"post_view",
"creative_assets",
"creative_derivatives"
],
"type": "string"
},
"description": "Promotion channels prohibited by the merchant for all publishers. An explicit empty list declares no additional prohibitions."
}
}
}| traffic_daily |
| integer |
| traffic_monthly | integer |
| placement_description | string | Short description of how/where links will be used. |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 5,
"maximum": 10,
"minimum": 1
},
"topic": {
"type": "string"
},
"sub_id": {
"type": "string",
"description": "Optional placement/sub ID for attribution."
},
"channel": {
"type": "string"
},
"country": {
"type": "string"
},
"category": {
"type": "string"
},
"claim_email": {
"type": "string",
"description": "Optional email to claim the account later; not required to get links."
},
"program_ids": {
"type": "array",
"items": {
"type": "integer"
},
"description": "Program IDs returned by find_affiliate_programs. If omitted, Clickwise picks fitting programs."
},
"publisher_url": {
"type": "string",
"description": "Where the affiliate will publish. URL/profile/app is strongly recommended."
},
"traffic_daily": {
"type": "integer"
},
"traffic_monthly": {
"type": "integer"
},
"placement_description": {
"type": "string",
"description": "Short description of how/where links will be used."
}
}
}| country |
| string |
| ISO 3166-1 alpha-2 market code, for example US or GB. Required unless you search by gtin. |
| category | string |
| currency | string | ISO 4217 code: only products priced in this currency (the price range then applies to it). |
| max_price | number | string | Inclusive upper price bound, in each product's own currency (no conversion). Number from 0 with up to 4 decimals. |
| min_price | number | string | Inclusive lower price bound, in each product's own currency (no conversion). Number from 0 with up to 4 decimals. |
{
"type": "object",
"properties": {
"gtin": {
"type": "string",
"maxLength": 14
},
"text": {
"type": "string",
"maxLength": 200
},
"brand": {
"type": "string",
"maxLength": 200
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
},
"subid": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,36}$",
"description": "Your own sub-ID for these links (up to 36 characters: letters, digits, _ or -; no personal data). A sale made through one of them reports it in your conversions."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 50000,
"minimum": 0
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "ISO 3166-1 alpha-2 market code, for example US or GB. Required unless you search by gtin."
},
"category": {
"type": "string",
"maxLength": 200
},
"currency": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "ISO 4217 code: only products priced in this currency (the price range then applies to it)."
},
"max_price": {
"type": [
"number",
"string"
],
"description": "Inclusive upper price bound, in each product's own currency (no conversion). Number from 0 with up to 4 decimals."
},
"min_price": {
"type": [
"number",
"string"
],
"description": "Inclusive lower price bound, in each product's own currency (no conversion). Number from 0 with up to 4 decimals."
}
},
"additionalProperties": false
}