# Clickwise — API and MCP for developers and AI agents

> Clickwise is an affiliate meta-network: one publisher account, one tracking link format and one payout
> across many merchant programs. Sites, apps, bots, creators and AI agents find programs and deals, create
> tracked links, read their conversions and call a product search endpoint (by text or GTIN) through a REST
> API or a remote MCP server. The complete version is https://partners.clickwise.net/llms-full.txt and the human page is https://partners.clickwise.net/developers/.

## Start here
- Complete guide in one file (quickstarts, API reference, MCP tools): https://partners.clickwise.net/llms-full.txt
- Developer hub with copy-paste quickstarts: https://partners.clickwise.net/developers/ — product search and GTIN lookup, WooCommerce/WP All Import, AI agent over MCP, deals bot, store built with Lovable/Bolt/v0
- Ready-made product file for affiliates, no code: CSV or XML of GTIN products with your own Clickwise /dl/ links already in every row; import it into a comparison table, a store with external products or a deals channel. How it works: https://partners.clickwise.net/en/gtin-product-feeds/
- Human page for AI agent and assistant builders: https://partners.clickwise.net/en/for-agents/
- Video walkthrough (1:28, AI-generated narration): https://partners.clickwise.net/media/video/p2-developers/cw_p2_developers_en_1080p_v3b.mp4 · transcript: https://partners.clickwise.net/developers/#video-transcript
- Sandbox key, no account: POST https://partners.clickwise.net/api/v1/developers/sandbox-keys/ (`{email, use_case}`); the emailed link reveals a `cw_sbx_` key once (it covers the product search and lookup calls, also through the MCP tool search_products; results depend on the merchants live in each market and can be empty; 14 days; sandbox links are examples).
- MCP for a publisher account with OAuth 2.1 sign-in: https://partners.clickwise.net/api/v1/mcp/account (metadata https://partners.clickwise.net/.well-known/oauth-protected-resource/api/v1/mcp/account)
- Trackers (Voluum, RedTrack, Binom, Keitaro, BeMob, ClickMagick): Clickwise as an affiliate network with a ready postback, the tracker's click ID goes in `sub_id` and returns as `{subid}`: https://partners.clickwise.net/developers/trackers/
- Reporting tools (Strackr): connect a reporting tool to a Clickwise publisher account with the Reporting API token (Results > Reporting connection), not the Publisher API key: https://partners.clickwise.net/developers/reporting/

## Discovery
- OpenAPI schema (public endpoints): https://partners.clickwise.net/api/v1/openapi.json
- Full OpenAPI schema (authenticated accounts only): https://partners.clickwise.net/api/v1/openapi-full.json
- Swagger UI: https://partners.clickwise.net/api/v1/docs/
- AI plugin manifest: https://partners.clickwise.net/.well-known/ai-plugin.json
- MCP manifest: https://partners.clickwise.net/.well-known/mcp.json · MCP server card (SEP-2127 draft): https://partners.clickwise.net/.well-known/mcp-server-card
- Sitemap: https://partners.clickwise.net/sitemap.xml
- Marketing site: https://clickwise.net
- Contact: partnerships@clickwise.net
- Talk to Clickwise's AI agent (voice, 24/7; it says it is an AI, and anything agreed is confirmed by email): +1 646 362 1368 (US) or https://partners.clickwise.net/talk
- Privacy policy: https://partners.clickwise.net/en/privacy/

## Public multilingual blog (no auth)
- Deals index: https://partners.clickwise.net/<lang>/deals/   (lang ∈ en, es, pt, fr, de, it)
- Deal detail: https://partners.clickwise.net/<lang>/deals/<slug>/
- Network news index: https://partners.clickwise.net/<lang>/news/
- News article: https://partners.clickwise.net/<lang>/news/<slug>/
- Newsletter signup: https://partners.clickwise.net/<lang>/newsletter/
- JSON API:  https://partners.clickwise.net/api/v1/deals/?lang=<lang>  ·  https://partners.clickwise.net/api/v1/news/?lang=<lang>
- RSS feed:  https://partners.clickwise.net/api/v1/deals/feed.<lang>.xml  ·  https://partners.clickwise.net/api/v1/news/feed.<lang>.xml
- Subscribers API: POST https://partners.clickwise.net/api/v1/subscribers/ (`{email, lang, frequency, categories}`)
- MCP server: https://partners.clickwise.net/api/v1/mcp/  (JSON-RPC 2.0; tools: search_products/get_product_feed/get_catalog_stats/list_deals/get_deal/list_news/get_news/find_affiliate_programs/request_tracked_links/get_monetization_feed/get_tracked_link_request/request_merchant_onboarding/list_programs/update_profile/get_click_report/list_my_programs/create_tracking_links/get_performance_report/list_conversions/get_payment_status/apply_to_program/list_my_weekly_deals/check_store/create_program/get_program_status/answer_program_question/get_merchant_credentials/get_tracking_link/get_conversions_key/get_integration_status/get_results) — manifest at https://partners.clickwise.net/.well-known/mcp.json

## GTIN product catalog
- Public pages: https://partners.clickwise.net/<lang>/product-catalog/ (en, es, pt, fr, de, it, nl). Existing /feeds/ links redirect here.
- Public sample: https://partners.clickwise.net/api/v1/public/catalog-sample/?country=ES&category= (up to 12 products); add &format=csv for up to 100 rows per country. Samples require current redistribution permission and contain no tracked product links.
- Affiliate registration: https://partners.clickwise.net/en/signup_affiliate/ (existing account registration).
- Endpoint: https://partners.clickwise.net/api/v1/mcp/ (Streamable HTTP, JSON-RPC 2.0).
- `get_catalog_stats`: public aggregate statistics; REST equivalent https://partners.clickwise.net/api/v1/public/catalog-stats/. Counts are as of generated_at, with fixed one-hour nominal validity. Catalog statistics are refreshed every 6 hours; freshness varies by network. snapshot_stale marks counts older than their one-hour validity, and the last snapshot is served with that mark for up to 7 days. Requests never rebuild. Fresh inventory is uncapped and applies network-wide delivery permissions and 48-hour freshness; the country breakdown describes that inventory. Standard delivery preview (standard_delivery) and category breakdowns apply current delivery caps; inventory_total also counts older, non-deliverable inventory. The country list comes from the snapshot, not a fixed market list. Individual access also depends on affiliate permissions and domain restrictions. No affiliate data or amounts are exposed.
- `search_products`: one country per call, filtered by GTIN, brand, text and category (a GTIN alone searches every market carrying it); `min_price`/`max_price` filter by price in each product's own currency (inclusive, no conversion) and `currency` keeps one currency. It accepts the sandbox key or your affiliate key in the X-API-Key header; results depend on the merchants live in each market and can be empty; sandbox links are examples.
- `get_product_feed`: retrieve eligible products with the authenticated affiliate's tracked links. Requires X-API-Key.
- Product tools return Clickwise /dl/ URLs only, never upstream network tracking URLs. Availability depends on affiliate permissions, current freshness and delivery limits; totals are not a promise of access for every affiliate.
- Send keys only in the header, never in tool arguments or URLs. Respect rate-limit errors and retry guidance.
- Claude Code and Cursor support header authentication. Clients that sign in with OAuth (Claude, ChatGPT, Cursor) use https://partners.clickwise.net/api/v1/mcp/account: scopes affiliate:read and affiliate:links, never applications, payout or approvals.

## Public affiliate program directory (no auth)
- Index: https://partners.clickwise.net/<lang>