KPL Analytics — API usage & billing links

Google Cloud Places + PageSpeed

Env: GOOGLE_PLACES_API_KEY, PAGESPEED_API_KEY (often the same key)
This app: Places Details + searchText; PageSpeed Insights v5 (mobile/desktop; peer runs optional).

• Google Cloud Console (home)
• APIs & Services — enabled APIs dashboard
• Places API (New) — product page
• PageSpeed Insights API — product page
• Credentials — API keys & restrictions
• Quotas — search “Places” / “PageSpeed”
• Billing — accounts & budgets
• Budgets & alerts
• Cloud Monitoring (optional deep metrics)

Pricing reference: Maps Platform pricing · PageSpeed Insights API docs

Stripe Checkout (test mode)

Env: STRIPE_PUBLISHED_KEY (pk_test_…), STRIPE_SECRET_KEY (sk_test_…)
This app: local website/serve_checkout.py · unified 3-step checkout (snapshot + subscriptions) · metadata kpl_place_id, email, plan. Optional: STRIPE_CHECKOUT_BASE_URL for return URLs.

• Payments (test)
• Customers (test)
• Subscriptions (test)
• Webhooks (test) — for future invoice.paid fulfillment
• API keys (test)

Docs: Test cards & sandboxes · Billing / subscription testing · Webhooks · API reference

Serper Maps / Search / Reviews

Env: SERPER_API_KEY
This app: maps, search, reviews, autocomplete (cached under .cache/ by default).

• Dashboard — credits, usage & API key
• Playground — try requests
• Serper home (docs linked from site)

xAI (Grok) Narrative option

Env: XAI_API_KEY when Grok is used for narrative sections (see pipeline config).

• xAI Console — API keys & usage (sign in required)
• xAI API documentation

Anthropic Narrative only

Env: CLAUDE_API_KEY (or ANTHROPIC_API_KEY if you switch)
This app: executive summary + themes in narrative.py — skip with Main.py --no-narrative.

• Anthropic Console
• Usage
• Billing
• API keys
• Plans & limits
• Rate limits (docs)

Manual checks (not billing)

Useful for QA; not tied to API quotas in this project.

• PageSpeed web UI (lab test)
• Google Business Profile

Local checkout (this repo)

Not a provider — run from project root. Requires test Stripe keys in .env.

• Marketing site + checkout (when server running)
• venv\Scripts\python website\serve_checkout.py
• Per-run audit costs: logs\transactions_YYYY-MM-DD.jsonl → run_cost.total_usd

Dev cost toggles (this repo)

Environment variables — not provider dashboards.

• KPL_SKIP_PEER_PSI=1 — skip competitor PageSpeed calls (high impact)
• KPL_DISABLE_SERPER_CACHE=1 — force fresh Serper requests
• KPL_DISABLE_PAGESPEED_CACHE=1 — force fresh PageSpeed requests
• SERPER_CACHE_TTL_SECONDS / PAGESPEED_CACHE_TTL_SECONDS — cache TTL (default 86400)
• enable_narrative: false in config + --narrative only for client PDFs