# Clickwise Panel v2 — API operator brief

> The Clickwise panel v2 is the operations console for an affiliate meta-network.
> It aggregates programs from many upstream affiliate networks (Awin, Tradedoubler,
> Lomadee, Partnerize, ShareASale, Webgains, …) 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: https://share.clickwise.net/api/v1/openapi.json
- Swagger UI: https://share.clickwise.net/api/v1/docs/
- AI plugin manifest: https://share.clickwise.net/.well-known/ai-plugin.json
- Sitemap: https://share.clickwise.net/sitemap.xml
- Marketing site: https://clickwise.net

## Public multilingual blog (no auth)
- Deals index: https://share.clickwise.net/<lang>/deals/   (lang ∈ en, es, pt, fr, de, it)
- Deal detail: https://share.clickwise.net/<lang>/deals/<slug>/
- Network news index: https://share.clickwise.net/<lang>/news/
- News article: https://share.clickwise.net/<lang>/news/<slug>/
- Newsletter signup: https://share.clickwise.net/<lang>/newsletter/
- JSON API:  https://share.clickwise.net/api/v1/deals/?lang=<lang>  ·  https://share.clickwise.net/api/v1/news/?lang=<lang>
- RSS feed:  https://share.clickwise.net/api/v1/deals/feed.<lang>.xml  ·  https://share.clickwise.net/api/v1/news/feed.<lang>.xml
- Subscribers API: POST https://share.clickwise.net/api/v1/subscribers/ (`{email, lang, frequency, categories}`)
- MCP server: https://share.clickwise.net/api/v1/mcp/  (JSON-RPC 2.0; tools: list_deals/get_deal/list_news/get_news/find_affiliate_programs/request_tracked_links/get_tracked_link_request/request_merchant_onboarding)

## Affiliate API (per-affiliate, Bearer-token, self-scoped)
- Token:   GET/POST https://share.clickwise.net/api/v1/affiliate-reporting/api-token/  (Authorization: Bearer <token>)
- Campaigns: GET https://share.clickwise.net/api/v1/affiliate-reporting/campaigns/
- Joinable: GET https://share.clickwise.net/api/v1/affiliate-reporting/joinable/  (ALL active campaigns you can apply to)
- Apply:    POST https://share.clickwise.net/api/v1/affiliate-reporting/apply/ (`{campaign_id}`) — Gemini quick-reviews: approve or ask for more info
- Mint link: POST https://share.clickwise.net/api/v1/affiliate-reporting/links/ (`{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://share.clickwise.net/api/v1/affiliate-reporting/sales/?since=&until=&subid=
- Summary: GET https://share.clickwise.net/api/v1/affiliate-reporting/summary/?group_by=subid
- Clicks:  GET https://share.clickwise.net/api/v1/affiliate-reporting/clicks/?days=7
- CSV:     GET https://share.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://share.clickwise.net/api/v1/auth/api-token/ (Authorization: Bearer <token>); dashboard at https://share.clickwise.net/api/v1/merchant-portal/dashboard/
- Conversions key: GET/POST https://share.clickwise.net/api/v1/merchant-portal/conversions-key/  → cw_mk_...
- Report a sale (network-agnostic): POST https://share.clickwise.net/api/v1/conversions/ with header `X-Merchant-Key: cw_mk_...` and JSON `{campaign, order_id, amount, commission, currency, event_type, cwclk}`
- 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://share.clickwise.net/api/v1/widgets/register/ (`{site_url, email?, category?}`) -> public_key + embed snippets. Gemini screens the site; tracking starts immediately, payout claimed later.
- Product feed: GET https://share.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://share.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://share.clickwise.net/api/v1/widgets/claim/ (`{public_key, email}`).

## Onboarding (AI-gated; human approves before live)
- Affiliate: POST https://share.clickwise.net/api/v1/onboarding/affiliate/  ·  CLI `cw onboard apply`  ·  MCP `request_tracked_links`
- Merchant:  POST https://share.clickwise.net/api/v1/onboarding/merchant/  ·  CLI `cw merchant apply`  ·  MCP `request_merchant_onboarding`
- Instant monetization REST API: https://share.clickwise.net/api/v1/monetize/
  - GET  https://share.clickwise.net/api/v1/monetize/programs/?publisher_url=<url>&topic=<topic>&country=<cc>&channel=<channel>
  - POST https://share.clickwise.net/api/v1/monetize/links/ (`{publisher_url, placement_description, program_ids?, sub_id?, claim_email?}`)
  - GET  https://share.clickwise.net/api/v1/monetize/requests/<application_id>/?access_secret=<secret>
  - GET/PATCH https://share.clickwise.net/api/v1/monetize/profile/<application_id>/?access_secret=<secret>
- Pages ship Open Graph + JSON-LD (Offer, NewsArticle, ItemList, WebPage), canonical, hreflang.

## Common reads
- `GET /api/v1/campaigns/?page_size=200`
- `GET /api/v1/network-catalog/programs/?network_slug__in=awin,tradedoubler`
- `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://share.clickwise.net/api/v1/mcp/
- Claude API `mcp_servers`: `{"type":"url","url":"https://share.clickwise.net/api/v1/mcp/","name":"clickwise"}`
- Antigravity `mcp_config.json`: `{"mcpServers":{"clickwise":{"serverUrl":"https://share.clickwise.net/api/v1/mcp/"}}}`
- Generic MCP clients can POST JSON-RPC 2.0 to the same endpoint; no auth required.

## Curated AI per campaign
- `GET  /api/v1/campaigns/<id>/insights/`
- `POST /api/v1/campaigns/<id>/insights/refresh/` (manager-only — re-runs Gemini)
- `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.