
Clickwise affiliate API: 1.1M+ products by GTIN, tracked affiliate links, remote MCP server.
Clickwise affiliate API: 1.1M+ products by GTIN, tracked affiliate links, remote MCP server. Quickstarts, TS/Python clients, affiliate store template.
·
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.
# How big is the catalog right now?
curl -s https://partners.clickwise.net/api/v1/public/catalog-stats/
# Sample products in one market (DE, ES, GB, PT, SE, FR, US); no links without a key
curl -s "https://partners.clickwise.net/api/v1/public/catalog-sample/?country=DE"
# Ask the MCP server which programs fit your site
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"}}}'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=... # never commit it, never ship it to a browser# Who am I, what can this key do, what are my limits?
curl -s https://partners.clickwise.net/api/v1/publisher/me/ -H "X-API-Key: $CLICKWISE_API_KEY"
# Price, stock and YOUR tracked link for up to 100 GTINs
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'
# Search by title in one market
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'
# Same kind of search in Germany (publisher key or sandbox key)
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.
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 Code
claude mcp add --transport http clickwise https://partners.clickwise.net/api/v1/mcp --header "X-API-Key: $CLICKWISE_API_KEY"
# OpenAI Codex CLI
codex mcp add clickwise --url https://partners.clickwise.net/api/v1/mcp
# Gemini CLI
gemini mcp add --transport http clickwise https://partners.clickwise.net/api/v1/mcpBoth buttons add the server URL without a key, which gives you the public tools. Cursor and Replit ask you to confirm before they add it. For the tools that need a key, add an X-API-Key header with your key to the server settings. Bolt, v0 and Lovable take the same URL as a custom MCP server: see the steps in mcp/.
Links returned by these tools are affiliate links: if someone buys through them, the publisher who shares them may receive a commission from the store.
/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 marketplace add softdevfz/clickwise-api, then codex plugin add clickwise@clickwise. The key, if set, is read from CLICKWISE_API_KEY.agy plugin install https://github.com/softdevfz/clickwise-api./plugins install https://github.com/softdevfz/clickwise-api, then /reload. It connects without a key; for the tools that need one, add the server to your Kimi Code MCP config with "bearerTokenEnvVar": "CLICKWISE_API_KEY".gemini extensions install https://github.com/softdevfz/clickwise-api. It adds the MCP server and GEMINI.md as context.SKILL.md (Claude, Codex and others): skills/clickwise-affiliate-links. Copy the folder into your agent's skills directory.Configs for Claude Code, Cursor, Replit, Claude Desktop, VS Code, ChatGPT, Grok, Bolt, v0, Lovable 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.
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
Thin, dependency-free clients generated from the OpenAPI, one method per operation:
clients/typescript/clickwise.ts (copy one file; Node, Bun, Deno, edge).clients/python (pip install "git+https://github.com/softdevfz/clickwise-api#subdirectory=clients/python").const cw = new Clickwise(); // CLICKWISE_API_KEY
const { products } = await cw.lookupProducts({ gtins: "4006381333931", country: "DE" });| 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.
openapi/)https://partners.clickwise.net/api/v1/mcphttps://partners.clickwise.net/Apiv3/jsonrel="sponsored" on links plus a visible disclosure).Retry-After.Questions and integration help: [email protected]. Bugs in this repo: open an issue.
MIT. Use of the Clickwise API itself is subject to your Clickwise publisher account terms.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/clickwise-api to learn what the "Clickwise Api" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
claude mcp add --transport http clickwise https://partners.clickwise.net/api/v1/mcp --header "X-API-Key: $CLICKWISE_API_KEY"| Name | What it does |
|---|---|
search_products | 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_sb |
get_product_feed | 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 re |
get_catalog_stats | 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 |
list_deals | List active Clickwise deals and offers, optionally filtered by language, category, country or merchant. |
get_deal | Fetch the full record for a single deal by its slug. Returns title, description, code, discount, target_url, etc., in the requested language. |
list_news | List Clickwise news announcements about affiliate programs (policy changes, launches, shutdowns, commission updates). |
get_news | Fetch the full record for a single news article by its slug. |
find_affiliate_programs | 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. |
request_tracked_links | 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 i |
get_monetization_feed | 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 retur |
get_tracked_link_request | Fetch a link request, affiliate RefId, review status, and issued links using its access secret. |
request_merchant_onboarding | 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 pa |
list_programs | 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 a |
update_profile | 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 |
get_click_report | 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 n |
list_my_programs | 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 |
create_tracking_links | 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-l |
get_performance_report | 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. Requi |
list_conversions | 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 |
get_payment_status | 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 |
apply_to_program | 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 A |
list_my_weekly_deals | Read the weekly deals available to your Clickwise affiliate account. Returns existing deal details only; no tracked links are created. Requires affiliate:read on your OAuth connection or your own affi |
check_store | Check a store domain against the Clickwise catalog. Returns up to five available programs, absent, or a neutral result. Requires an affiliate OAuth connection with affiliate:read. Send a domain only, |
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 |
get_program_status | Read the application and pending question using application_id and access_secret. |
answer_program_question | Answer the application question. An agent calls this at a person's request. |
get_merchant_credentials | 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 t |
get_tracking_link | 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. |
get_conversions_key | Reveal a new conversions key once, or rotate with rotate=true. An agent calls this at a person's request. Merchant Bearer token required. |
get_integration_status | Read authenticated test-sale evidence and the last real sale. Merchant Bearer token required. |
get_results | Read native direct program clicks, pending, approved and rejected conversions, commission by currency and billing status. Merchant Bearer token required. |
Read live from the server on November 15, 2026.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/clickwise-api)Nothing comparable is listed yet.
v1.0.0Release notesConnect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "clickwise-api" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.