# Clickwise Panel v2 — API operator brief

> The Clickwise panel v2 is the operations console for an affiliate meta-network.
> It brings programs from several affiliate networks under one panel, one tracking
> link, one payout. Managers, merchants, and affiliates use this panel directly;
> agents integrate via the REST API.

## 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
- Sitemap: https://partners.clickwise.net/sitemap.xml
- Marketing site: https://clickwise.net
- Contact: partnerships@clickwise.net
- Privacy policy: https://panel-v2.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) — 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. The worker refreshes every 30 minutes; snapshot_stale marks the last good snapshot served for up to six hours. 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). Requires the authenticated affiliate's API key in the X-API-Key header.
- `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. ChatGPT and Smithery authenticated compatibility requires separate verification; no OAuth flow is advertised by this API-key integration.

## Public affiliate program directory (no auth)
- Index: https://partners.clickwise.net/<lang>/affiliate-programs/
- Detail: https://partners.clickwise.net/<lang>/affiliate-programs/<slug>/
- Banpresto Affiliate Program: https://partners.clickwise.net/en/affiliate-programs/banpresto/
- Casa del Libro Affiliate Program: https://partners.clickwise.net/en/affiliate-programs/casa-del-libro/
- Central de Reservas Affiliate Program: https://partners.clickwise.net/en/affiliate-programs/central-de-reservas/
- Creditilia affiliate program: https://partners.clickwise.net/en/affiliate-programs/creditilia/
- Flynas Affiliate Program: https://partners.clickwise.net/en/affiliate-programs/flynas/
- Footdistrict Affiliate Program: https://partners.clickwise.net/en/affiliate-programs/footdistrict/
- Galaxus Affiliate Program: https://partners.clickwise.net/en/affiliate-programs/galaxus/
- GameSeal Affiliate Program: https://partners.clickwise.net/en/affiliate-programs/gameseal/
- GetYourGuide Affiliate Program: https://partners.clickwise.net/en/affiliate-programs/getyourguide/
- Havaianas Affiliate Program: https://partners.clickwise.net/en/affiliate-programs/havaianas/
- Iberia Affiliate Program: https://partners.clickwise.net/en/affiliate-programs/iberia/
- IKEA ES affiliate program: https://partners.clickwise.net/en/affiliate-programs/ikea-es/
- Inside Affiliate Program: https://partners.clickwise.net/en/affiliate-programs/inside/
- Kioskoymás Affiliate Program: https://partners.clickwise.net/en/affiliate-programs/kioskoymas/
- Levi's Affiliate Program: https://partners.clickwise.net/en/affiliate-programs/levis/
- Logitech EMEA Affiliate Program: https://partners.clickwise.net/en/affiliate-programs/logitech-emea/
- MaxMovil Affiliate Program: https://partners.clickwise.net/en/affiliate-programs/maxmovil/
- MobiMatter Affiliate Program: https://partners.clickwise.net/en/affiliate-programs/mobimatter/
- MyTrip affiliate program: https://partners.clickwise.net/en/affiliate-programs/mytrip/
- Naturecan Affiliate Program: https://partners.clickwise.net/en/affiliate-programs/naturecan/
- Nomad eSIM affiliate program: https://partners.clickwise.net/en/affiliate-programs/nomad-esim/
- QuePrestamo Affiliate Program: https://partners.clickwise.net/en/affiliate-programs/queprestamo/
- Singularu Affiliate Program: https://partners.clickwise.net/en/affiliate-programs/singularu/
- SSENSE affiliate program: https://partners.clickwise.net/en/affiliate-programs/ssense/
- Teachable affiliate program: https://partners.clickwise.net/en/affiliate-programs/teachable/
- Telepizza Affiliate Program: https://partners.clickwise.net/en/affiliate-programs/telepizza/
- TOUS affiliate program: https://partners.clickwise.net/en/affiliate-programs/tous/
- Trip.com affiliate program: https://partners.clickwise.net/en/affiliate-programs/trip-com/
- Tutete ES Affiliate Program: https://partners.clickwise.net/en/affiliate-programs/tutete-es/
- Welcome affiliate program: https://partners.clickwise.net/en/affiliate-programs/welcome-pickups/
- Welcome Affiliate Program: https://partners.clickwise.net/en/affiliate-programs/welcome/
- YOOX affiliate program: https://partners.clickwise.net/en/affiliate-programs/yoox/

## Affiliate API (per-affiliate, Bearer-token, self-scoped)
- Token:   GET/POST https://partners.clickwise.net/api/v1/affiliate-reporting/api-token/  (Authorization: Bearer <token>)
- Campaigns: GET https://partners.clickwise.net/api/v1/affiliate-reporting/campaigns/?include_available=true&q=stockx
- Joinable: GET https://partners.clickwise.net/api/v1/affiliate-reporting/joinable/?q=stockx  (program-aware; each row returns `apply_with`)
- Apply:    POST https://partners.clickwise.net/api/v1/affiliate-reporting/apply/ (`{program_id}` or `{campaign_id}`) — automated quick review: approve or ask for more info
- Mint link: POST https://partners.clickwise.net/api/v1/affiliate-reporting/links/ (`{program_id|campaign_id, link_mode: standard|transparent|smart, extra_data: <subid>, smart_rules?}`) — returns cw_link + certified_tracking_link (transparent t.clickwise.net)
- Sales:   GET https://partners.clickwise.net/api/v1/affiliate-reporting/sales/?since=&until=&subid=
- Summary: GET https://partners.clickwise.net/api/v1/affiliate-reporting/summary/?group_by=subid
- Clicks:  GET https://partners.clickwise.net/api/v1/affiliate-reporting/clicks/?days=7
- CSV:     GET https://partners.clickwise.net/api/v1/affiliate-reporting/sales/export/
- CLI: `cw affiliate token|campaigns|links|sales|summary|clicks|export`

## Merchant API (per-merchant)
- API token (reads): GET/POST https://partners.clickwise.net/api/v1/auth/api-token/ (Authorization: Bearer <token>); dashboard at https://partners.clickwise.net/api/v1/merchant-portal/dashboard/
- Conversions key: GET/POST https://partners.clickwise.net/api/v1/merchant-portal/conversions-key/  → cw_mk_...
- Report a sale (network-agnostic): POST https://partners.clickwise.net/api/v1/conversions/ with header `X-Merchant-Key: cw_mk_...` and JSON `{campaign, order_id, amount, commission, payout, currency, event_type, cwclk, status}`. `status` drives the payable lifecycle (pending → confirmed → refunded); re-POST the same order with a new status to update it. Attributed conversions land in the affiliate's commission ledger automatically.
- CLI: `cw merchant token|report|conversions-key|push-conversion`

## Frictionless monetization (anyone can monetize any site, no account up front)
- Register a site: POST https://partners.clickwise.net/api/v1/widgets/register/ (`{site_url, email?, category?}`) -> public_key + embed snippets. An automated check screens the site; tracking starts immediately, payout claimed later.
- Product feed: GET https://partners.clickwise.net/api/v1/feeds/products/?key=cw_pub_...&category=&country=&limit=&format=json|csv -> tracked products (redirect + transparent t.clickwise.net links).
- Embed loader: <script async src="https://partners.clickwise.net/api/v1/widgets/loader.js"></script> then a div with data-cw-widget="banner|assistant" data-cw-key="cw_pub_...". Rotating product banners + an AI assistant-caller widget.
- Claim payouts later: POST https://partners.clickwise.net/api/v1/widgets/claim/ (`{public_key, email}`).

## Onboarding (AI-gated; human approves before live)
- Affiliate: POST https://partners.clickwise.net/api/v1/onboarding/affiliate/  ·  CLI `cw onboard apply`  ·  MCP `request_tracked_links`
- Merchant:  POST https://partners.clickwise.net/api/v1/onboarding/merchant/  ·  CLI `cw merchant apply`  ·  MCP `request_merchant_onboarding`
- Instant monetization REST API: https://partners.clickwise.net/api/v1/monetize/
  - GET  https://partners.clickwise.net/api/v1/monetize/programs/?publisher_url=<url>&topic=<topic>&country=<cc>&channel=<channel>  (add page=&page_size= to browse the WHOLE catalog)
  - POST https://partners.clickwise.net/api/v1/monetize/links/ (`{publisher_url, placement_description, program_ids?, sub_id?, claim_email?}`)
  - POST https://partners.clickwise.net/api/v1/monetize/social-post/ (`{post_text, channel, country?, claim_email?}`) -> suggested post copy + tracked links
  - POST https://partners.clickwise.net/api/v1/monetize/apply/ (`{profile_url, niche?, name?, email?, channel?, country?}`) -> matched programs + instant links + a free link-in-bio
  - GET  https://partners.clickwise.net/api/v1/monetize/requests/<application_id>/?access_secret=<secret>
  - GET/PATCH https://partners.clickwise.net/api/v1/monetize/profile/<application_id>/?access_secret=<secret>
- Pages ship Open Graph + JSON-LD (Offer, NewsArticle, ItemList, WebPage), canonical, hreflang.

## Creators & influencers (monetize in one chat — no signup, no pixel, payout claimed later)
> Best path for an AI assistant helping a creator: list_programs / find_affiliate_programs to pick merchants → request_tracked_links to mint live links instantly (email optional; returns application_id + access_secret + profile_url) → creator publishes → update_profile to add claim_email + payout. Every link tracks from the first click, so the creator earns before claiming.
- Apply page (humans): https://partners.clickwise.net/creators/apply/  — paste a handle/site, get tracked links + a free link-in-bio in under a minute.
- Social-post monetizer page: https://partners.clickwise.net/creators/  — paste a caption, get FTC-disclosed, affiliate-linked copy.
- Public link-in-bio: https://partners.clickwise.net/bio/<slug>/  (created on apply; links only, rel="nofollow sponsored" + #ad).
- MCP (AI assistants): list_programs, find_affiliate_programs, request_tracked_links, update_profile at https://partners.clickwise.net/api/v1/mcp/.
- CLI (one tool, no login): `cw monetize programs|links|social-post|apply|profile|claim` — wraps the public https://partners.clickwise.net/api/v1/monetize/* API.

## Common reads
- `GET /api/v1/campaigns/?page_size=200`
- `GET /api/v1/network-catalog/programs/?network_slug__in=<slug>,<slug>`
- `GET /api/v1/transactions/?date_from=2026-01-01`
- `GET /api/v1/dashboard/`
- `GET /api/v1/deals/?lang=es&category=fashion`
- `GET /api/v1/news/?lang=en&severity=critical`
- `GET /api/v1/monetize/programs/?publisher_url=https://example.com&topic=travel&country=US`

## MCP client setup
- Streamable HTTP endpoint: https://partners.clickwise.net/api/v1/mcp/
- Claude API `mcp_servers`: `{"type":"url","url":"https://partners.clickwise.net/api/v1/mcp/","name":"clickwise"}`
- Antigravity `mcp_config.json`: `{"mcpServers":{"clickwise":{"serverUrl":"https://partners.clickwise.net/api/v1/mcp/"}}}`
- Generic MCP clients can POST JSON-RPC 2.0 to the same endpoint; only search_products and get_product_feed need an X-API-Key header.

## Curated AI per campaign
- `GET  /api/v1/campaigns/<id>/insights/`
- `POST /api/v1/campaigns/<id>/insights/refresh/` (manager-only — re-runs the analysis)
- `POST /api/v1/campaigns/<id>/queries/` — affiliate submits a question for the merchant

## Auth
- Bearer / session auth required for manager/affiliate/merchant account data.
- Public no-auth surfaces: `/health/`, `/openapi.json`, `/docs/`, `/.well-known/`,
  `/api/v1/deals/`, `/api/v1/news/`, `/api/v1/subscribers/`,
  `/api/v1/mcp/`, `/api/v1/monetize/`, and this file.

## Rules for AI agents
- Never call write endpoints without an explicit human prompt.
- Always quote the campaign id when discussing a campaign.
- Treat insights generated here as draft until a manager pins them.