// Changelog
What's New
Latest updates to The Polaris Report API and platform.
Custom API Domain
The API is now served at api.thepolarisreport.com. All endpoints, SDKs, documentation, and code examples have been updated.
Usage-Based Metered Billing
New pay-as-you-go billing model alongside existing subscriptions. $0/mo base with 1,000 free API calls per day, then $0.001 per additional call and $0.10 per custom brief. Stripe handles metered invoicing monthly. Set up via POST /api/v1/billing/setup-usage or from the pricing page.
Billing API Endpoints
Three new billing endpoints: POST /api/v1/billing/setup-usage for pay-as-you-go onboarding, POST /api/v1/billing/upgrade for subscription plan changes, and PUT /api/v1/billing/cap for spending cap management. GET /api/v1/usage now includes billing_model and metered_estimate for usage-plan subscribers.
OpenClaw Skill Published
polaris-report is now live on ClawHub. Install with 'clawhub install polaris-report' to get /news, /brief, /search, and /trending commands in any OpenClaw agent. Includes privacy disclosure and correct pricing for all tiers.
Database Backup & Recovery
Automated database backup with compressed snapshots and configurable retention. One-command backup and restore via CLI or admin dashboard. Scheduled backups supported via API endpoint.
Structured Logging
All backend logging migrated to structured JSON for better observability and alerting. Production logs are machine-parseable for log aggregation services. Critical infrastructure events are automatically flagged for monitoring.
Response Caching
All feed endpoints now deliver faster response times with caching that persists across deploys. X-Cache header shows cache hit/miss status.
Enhanced Health Endpoint
GET /health now returns three-tier status (ok / degraded / critical) with version and uptime information. Degraded and critical states automatically trigger monitoring alerts.
Pipeline Performance Upgrade
AI verification pipeline now processes briefs significantly faster with zero impact on content quality.
Security Headers & Content Security Policy
Added X-Frame-Options, X-Content-Type-Options, Referrer-Policy, Permissions-Policy, HSTS (2-year preload), and a strict Content-Security-Policy across all pages. Frame embedding blocked, MIME sniffing prevented.
Database Performance Optimization
Database query performance improvements across feed, search, and analytics endpoints. Faster page loads and API responses.
Frontend Performance Optimizations
Reduced unnecessary re-renders, lazy-loaded heavy components, and added loading skeletons across all vertical pages for smoother navigation.
High-Scale Infrastructure
Infrastructure upgrades for handling high traffic loads. CDN-friendly headers for edge caching, rate limiting, and improved health monitoring.
Query Performance Fix
Optimized source fetching across feed, search, and market endpoints. Significantly reduces database load per request.
Distributed Rate Limiting
Rate limiters now use distributed state across instances. Response caching persists across deploys.
OpenClaw Skill Package
Install polaris-report via OpenClaw to get verified intelligence in any agent or chat platform. Four slash commands: /news for latest briefs, /brief for on-demand generation, /search for full-text search, and /trending for top stories.
Curated Lists
Create, manage, and share curated collections of briefs. Toggle lists between public and private, browse community lists on the Discover page, and add briefs to any list from the feed or brief page.
Usage Analytics Dashboard
New usage dashboard with area chart showing API calls over time, top endpoints breakdown, and tiered limit warnings with plan upgrade prompts.
Social Sharing OG Images
Branded Open Graph image cards generated for every brief. Shows headline, summary, category badge, bias score, and source count — optimized for Twitter, LinkedIn, and iMessage previews.
Mobile Optimizations
Larger touch targets, responsive bias labels, stacked sports tabs, mobile notification bell, brief actions row wrapping, and CTA button sizing across all pages.
Rate Limit Modal Fix
Upgrade modal now only appears when you hit your daily plan limit, not on per-minute throttles. Improved rate limit handling for a smoother user experience.
Error Boundaries & Loading States
Added error boundaries and loading skeletons across all pages for graceful error recovery and smoother page transitions.
Compare & Analytics Bug Fixes
Fixed compare page crash from mismatched API response shape, analytics configuration issue, shared URLs error, and trending briefs 404 from UUID normalization.
Brief Comparison View
Compare two briefs side-by-side at /compare. See provenance bars, bias scores, source lists, and shared sources highlighted between briefs.
Weekly & Daily Email Digests
Subscribe to automated email digests with your favorite categories. Choose daily or weekly frequency, pick a delivery day and hour, and receive a branded roundup of top briefs. Admins can trigger digests manually.
JavaScript & Python SDKs
Official SDKs coming soon: @polaris/api for JavaScript/TypeScript and polaris-news for Python. Typed clients for feed, search, generate, and agent endpoints.
Slack & Discord Webhook Integration
Send webhook payloads formatted for Slack (Block Kit) or Discord (embeds). Select the format when creating a webhook — no middleware needed.
Embeddable Brief Widget
Embed a live brief feed on any website with a single script tag. Supports category filtering, dark/light themes, and configurable brief count.
Personalized "For You" Feed
Logged-in users can toggle a personalized feed ranked by reading history, bookmarks, and topic alerts. Falls back to recency when no data is available.
Topic Alerts
Create keyword and category-based alerts that trigger in-app notifications when a matching brief is published. Plan-based limits from 1 (free) to 50 (Agent Pro).
In-App Notification Center
Bell icon in the nav bar with unread count badge. Polls every 60 seconds, shows notification history with mark-read and mark-all-read actions.
Reading History
Your reading history is now tracked and visible in the dashboard. Includes a "Continue Reading" shortcut and full history with timestamps.
Bookmarks & Saved Briefs
Save briefs with a single click from the feed or brief page. Manage saved briefs from the dashboard with quick remove.
API Key Rotation
Rotate API keys instantly from the developer dashboard. The old key is revoked immediately and a new key is generated with the same name and scopes.
Webhook Delivery History
View the last 50 delivery attempts for each webhook, including status, response code, latency, and error messages. Expand any webhook to inspect its delivery log.
Request Log Filtering & Pagination
Filter API request logs by status code range (2xx, 4xx, 5xx) and endpoint path. Load more results with offset-based pagination.
Playground Response Headers
API Playground now shows response headers in a collapsible panel. Rate limit headers (RateLimit-Limit, Remaining, Reset) are highlighted for easy visibility.
Getting Started Wizard
New users see a guided 3-step onboarding flow: create your first API key, make your first call, and see the live response — all without leaving the dashboard.
Per-Key Usage Breakdown
Expand any API key to see calls today, calls this month, success rate, and top endpoints. Usage data is lazy-loaded per key.
Error Reference & Rate Limit Docs
API documentation now includes a complete error code reference (400–500), per-minute and daily plan rate limit tables, rate limit header explanations, and a JavaScript retry strategy example.
Developer Portal & Self-Service API Keys
Full developer portal with API key management, usage tracking, per-key daily limits, interactive playground, and comprehensive API documentation. Agents and developers can now register, create keys, and start building without contacting support.
Webhook Subscriptions
Subscribe to real-time webhook notifications for brief.published, brief.trending, and brief.corrected events. HMAC-SHA256 signed payloads with automatic retry and failure tracking.
API Request Logs & Usage Alerts
View your last 50 API requests with status codes and latency. Receive email alerts at 80% and 100% of your daily API call limit.
API Key Scoping
Create API keys restricted to specific endpoints or categories. Enterprise-grade access control for multi-team deployments.
API Status Page
Real-time API health monitoring at /status. Shows database connectivity, content freshness, and overall system status.
Trending Brief Auto-Expiry
Trending briefs now automatically expire to keep the feed fresh. No longer requires a manual pipeline run to rotate.
Plan-Based Rate Limiting
API calls are now tracked per-key with plan-based daily limits: Explorer 100/day, Consumer 100/day, Starter 3,000/day, Agent Pro 10,000/day, Usage 1,000 free/day then metered. 429 responses include upgrade URL.
User Account Management
Password reset via email, profile editing, email verification, account deletion, and Stripe billing portal integration.
Query Parameter Authentication
API keys can now be passed via ?api_key= query parameter in addition to the Authorization header. Useful for quick testing and webhook URLs.
Sports Category Launch
Added sports scores and news coverage. Real-time scores from major leagues integrated into the feed and available via /api/v1/sports/scores.
Diversified Brief Generation
Pipeline now ensures broader coverage across all 18 verticals with improved deduplication.