# 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://panel-v2.clickwise.net/api/v1/openapi.json
- Swagger UI: https://panel-v2.clickwise.net/api/v1/docs/
- AI plugin manifest: https://panel-v2.clickwise.net/.well-known/ai-plugin.json
- Sitemap: https://panel-v2.clickwise.net/sitemap.xml
- Marketing site: https://clickwise.net

## Public multilingual blog (no auth)
- Deals index: https://panel-v2.clickwise.net/<lang>/deals/   (lang ∈ en, es, pt, fr, de, it)
- Deal detail: https://panel-v2.clickwise.net/<lang>/deals/<slug>/
- Network news index: https://panel-v2.clickwise.net/<lang>/news/
- News article: https://panel-v2.clickwise.net/<lang>/news/<slug>/
- Newsletter signup: https://panel-v2.clickwise.net/<lang>/newsletter/
- JSON API:  https://panel-v2.clickwise.net/api/v1/deals/?lang=<lang>  ·  https://panel-v2.clickwise.net/api/v1/news/?lang=<lang>
- RSS feed:  https://panel-v2.clickwise.net/api/v1/deals/feed.<lang>.xml  ·  https://panel-v2.clickwise.net/api/v1/news/feed.<lang>.xml
- Subscribers API: POST https://panel-v2.clickwise.net/api/v1/subscribers/ (`{email, lang, frequency, categories}`)
- MCP server: https://panel-v2.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)
- Instant monetization REST API: https://panel-v2.clickwise.net/api/v1/monetize/
  - GET  https://panel-v2.clickwise.net/api/v1/monetize/programs/?publisher_url=<url>&topic=<topic>&country=<cc>&channel=<channel>
  - POST https://panel-v2.clickwise.net/api/v1/monetize/links/ (`{publisher_url, placement_description, program_ids?, sub_id?, claim_email?}`)
  - GET  https://panel-v2.clickwise.net/api/v1/monetize/requests/<application_id>/?access_secret=<secret>
  - GET/PATCH https://panel-v2.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://panel-v2.clickwise.net/api/v1/mcp/
- Claude API `mcp_servers`: `{"type":"url","url":"https://panel-v2.clickwise.net/api/v1/mcp/","name":"clickwise"}`
- Antigravity `mcp_config.json`: `{"mcpServers":{"clickwise":{"serverUrl":"https://panel-v2.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.