Clickwise API: products by GTIN, tracked affiliate links, MCP

Clickwise is an affiliate network with an API built for developers and AI agents. Search product feeds with GTINs from the networks, get product links tracked to you, find and join affiliate programs, and pull your conversions. Use it over REST, from an AI agent through MCP, or from HasOffers-compatible tools.
This repo gets you from zero to a working call: quickstarts, thin clients, MCP configs and a deployable affiliate store.
1. First call, no key
curl -s https://partners.clickwise.net/api/v1/public/catalog-stats/
curl -s "https://partners.clickwise.net/api/v1/public/catalog-sample/?country=DE"
curl -s https://partners.clickwise.net/api/v1/mcp \
-H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"find_affiliate_programs","arguments":{"topic":"sneakers","country":"ES","channel":"site"}}}'
2. Get your key
Request a publisher API key at https://partners.clickwise.net/developers/. Put it in an environment variable and keep it on your server:
export CLICKWISE_API_KEY=...
3. First call with your key
curl -s https://partners.clickwise.net/api/v1/publisher/me/ -H "X-API-Key: $CLICKWISE_API_KEY"
curl -s --get https://partners.clickwise.net/api/v1/publisher/products/lookup/ \
-H "X-API-Key: $CLICKWISE_API_KEY" \
--data-urlencode 'gtins=4006381333931,5901234123457' --data-urlencode 'country=DE'
curl -s --get https://partners.clickwise.net/api/v1/publisher/products/ \
-H "X-API-Key: $CLICKWISE_API_KEY" \
--data-urlencode 'q=sneaker' --data-urlencode 'country=GB' --data-urlencode 'limit=20'
curl -s --get https://partners.clickwise.net/api/v1/publisher/products/ \
-H "X-API-Key: $CLICKWISE_API_KEY" \
--data-urlencode 'q=smartwatch' --data-urlencode 'country=DE' --data-urlencode 'limit=20'
Each product comes back as {"gtin", "title", "price", "currency", "image", "url", "merchant", "availability", ...}. url is your tracked link: publish it exactly as returned.
Runnable versions of steps 1 and 3: quickstart/curl.sh · quickstart/quickstart.mjs (Node 18+) · quickstart/quickstart.py (Python 3.8+). No dependencies.
4. Use it from an AI agent (MCP)
Remote MCP server (Streamable HTTP): https://partners.clickwise.net/api/v1/mcp, listed in the official MCP Registry as net.clickwise/mcp. The key is optional: program discovery, deals, catalog stats and provisional tracked links work without it.
claude mcp add --transport http clickwise https://partners.clickwise.net/api/v1/mcp --header "X-API-Key: $CLICKWISE_API_KEY"
codex mcp add clickwise --url https://partners.clickwise.net/api/v1/mcp
gemini mcp add --transport http clickwise https://partners.clickwise.net/api/v1/mcp
Plugins, extensions and skills
- Claude Code plugin (MCP server plus the skill below):
/plugin marketplace add softdevfz/clickwise-api, then /plugin install clickwise@clickwise. Set CLICKWISE_API_KEY in your environment to use the tools that need a key.
- Codex plugin (same MCP server and skill):
codex plugin marketplace add softdevfz/clickwise-api, then codex plugin add clickwise@clickwise. The key, if set, is read from CLICKWISE_API_KEY.
- Antigravity CLI plugin:
agy plugin install https://github.com/softdevfz/clickwise-api.
- Gemini CLI extension:
gemini extensions install https://github.com/softdevfz/clickwise-api. It adds the MCP server and GEMINI.md as context.
- Agent Skill for any agent that reads
SKILL.md (Claude, Codex and others): skills/clickwise-affiliate-links. Copy the folder into your agent's skills directory.
Configs for Claude Code, Cursor, Claude Desktop, VS Code, ChatGPT, Grok and n8n, plus the tool list, in mcp/.
Earn commission from your AI assistant (product search, sub-IDs and signed postbacks): quickstart/monetize-agent.md.
5. Ship an affiliate store
templates/affiliate-store: a Next.js storefront that reads products by GTIN, shows live prices and publishes your tracked links. It deploys without a key in preview mode.

Building with Lovable, Bolt or v0? Paste templates/affiliate-store/PROMPT.md.
Running your own app or SaaS? Paste templates/merchant-tracking/PROMPT.md into Lovable, Bolt or v0 to add Clickwise sales tracking with Stripe, Lemon Squeezy or the conversions API.
WooCommerce: import the Clickwise product feed with WP All Import → guides/woocommerce/wp-all-import.md
6. Clients
Thin, dependency-free clients generated from the OpenAPI, one method per operation:
const cw = new Clickwise();
const { products } = await cw.lookupProducts({ gtins: "4006381333931", country: "DE" });
What the API covers
| Area | Endpoints (/api/v1/publisher/…) |
|---|
| Products | GET products/ search · GET products/lookup/ by id or GTIN (1–100) |
| Programs | GET programs/ · GET programs/joinable/ · POST programs/apply/ |
| Links | GET/POST links/ · POST links/batch/ (up to 50, each with its own status) |
| Reporting | GET conversions/ · GET reports/ (day, week, month, sub-ID, campaign, status) · GET clicks/ |
| Postbacks | GET postback/ · POST postback/test/ · GET postback/deliveries/ (signed HMAC webhooks) |
| Account | GET me/: access and rate limits for your key |
One error shape ({"error": {"code", "message", "status", "request_id"}}), RateLimit-* headers on every response, Retry-After on 429, Idempotency-Key on POST, X-Request-Id everywhere. Changes inside v1 are additive.
Reference
Rules of the road
- Keep the key on your server. A key acts only for its own account and never has admin access.
- Publish product and tracking links exactly as returned, and disclose affiliate relationships (
rel="sponsored" on links plus a visible disclosure).
- Refresh prices at least every 48 hours; hide products a lookup no longer returns.
- Honour rate limits: back off on 429 using
Retry-After.
Support
Questions and integration help: partnerships@clickwise.net. Bugs in this repo: open an issue.
License
MIT. Use of the Clickwise API itself is subject to your Clickwise publisher account terms.