Partners

Per-partner analytics report

The partner analytics product: what travelers and AI agents ask about one operator's upgrade program (by intent and route), the AI-check → bid → paid funnel by channel, the agent mix, AI visibility (share of answer per engine, who gets cited instead, what agents say, where answers are wrong), open content gaps/drift, and observed bid ranges. A partner-scoped token (the partner claim) is locked to its own operator and must NOT pass partner; an unscoped token must pass partner. Same object the MCP partner_question_insights tool returns in structuredContent.

get/api/v1/analytics

Request

  • Base URL: https://www.upgradeagent.ai
  • URL: https://www.upgradeagent.ai/api/v1/analytics
  • Auth: one of:
    • OAuth 2 (authorization code, authorization URL https://www.upgradeagent.ai/api/oauth/authorize, token URL https://www.upgradeagent.ai/api/oauth/token, scopes: mcp)
    • HTTP bearer

Query parameters

partnerstring

Slug, IATA code, or operator name — required for unscoped tokens, rejected for partner-scoped tokens.

window'7d' | '30d' | '90d'

Report window.

Response

The report.

generatedAtstring required
notesstring[] required

Data-availability notes (a source unavailable in this window).

Changes

No recorded changes to this operation across all 1 revision of this API.