// Changelog
What's New
Latest updates to The Polaris Report API and platform.
URL Content Extraction
New POST /api/v1/extract endpoint lets you pull clean article text from any URL. Send up to 5 URLs per request and get back structured text, word count, title, domain, language, and published date. Each successful extraction costs 1 API credit. Rate limited to 10 requests/minute.
Search Speed Tiers
The search endpoint now supports a depth parameter with three tiers. Use depth=fast for sub-100ms responses (skips highlights, facets, and related queries). Use depth=deep to get entity cross-references across briefs and source link verification via live HEAD checks — results capped at 10 with timing metadata included.
Source Domain Filtering
Filter briefs by source domain on /feed, /search, and /agent-feed. Use include_sources to show only briefs citing specific outlets (e.g. reuters.com,bbc.com) or exclude_sources to hide them. Works across all three feed endpoints.
Project-Level Usage Tracking
Pass an X-Project-ID header on any API request to tag calls by project. View per-project usage breakdowns via GET /usage?project_id=my-project.
Official Python & TypeScript SDKs
Typed SDK clients for Python (polaris-news) and TypeScript (polaris-news-api) are now live. Covers all 14 endpoints — feed, search, generate, entities, streaming, and more. Built-in error handling, auth, and SSE streaming support. Install with pip or npm and start building in seconds.
Intelligent Search
Search got a major upgrade. Results are now ranked smarter — headline matches surface first. Sort by relevance, newest, oldest, confidence, or most sources. Filter by entity or sentiment. Each category shows how many results it has. Related topics appear below results to help you explore further. Matching words are highlighted in headlines, summaries, and body text so you can see exactly why a brief matched.
Search Autocomplete
Start typing and get instant suggestions — matching brief headlines and trending entities appear in a dropdown as you type. Click a headline to jump straight to the brief, or click an entity to search for it.
Search API Upgrade
The search API now supports real pagination, five sort modes, entity and sentiment filters, category counts, highlighted snippets, related query suggestions, and response timing. New autocomplete endpoint returns matching headlines and entities as you type.
Search Everywhere
Search is now front and center. A search bar in the homepage hero lets you jump straight into finding intelligence. The feed page has a prominent search link above trending stories. Search is in the main nav and the More dropdown. Finding information should never be more than one click away.
Smarter Content Selection
Briefs now cover a wider range of topics in every cycle. Improved selection ensures no single category dominates the feed — you'll see more balanced coverage across all 18 verticals, with priority given to trending and high-signal stories.
Compare Search Improvements
Topic search on the Compare page now works reliably for short queries like single keywords. Previously, some searches returned no results even when relevant coverage existed.
Source Bias Comparison
See how different outlets frame the same story — side by side. Every brief now shows how each source covered the topic: what they emphasized, what they left out, and where they lean politically. A synthesis view reveals what the left and right focus on, what everyone misses, and which facts hold up across outlets. Paste your own article URLs to compare any coverage head-to-head. Every comparison gets a shareable link with dynamic social previews.
Bias Comparison API
New API endpoints for source bias comparison — analyze any brief or set of article URLs and get per-outlet framing breakdowns, political lean scores, and a cross-outlet synthesis. Every comparison returns a shareable ID for permanent links. Build bias-aware features on top of Polaris intelligence.
Media Bias Comparison
Compare how different outlets frame the same story — see framing, loaded language, political lean, and what each side emphasizes or omits. Paste article URLs, search a topic, or pick a brief. Every comparison gets a shareable link with dynamic social previews.
Real-Time Streaming
Watch briefs appear the moment they're published with our new live stream. Subscribe to specific categories, filter in real-time, and get instant alerts for trending stories. Available via SSE and WebSocket — no polling required.
Framework Integration Guides
Full code examples for LangChain, LlamaIndex, TypeScript, OpenAI function calling, and MCP — drop Polaris intelligence into any AI stack with copy-paste integration. Includes all endpoints: search, feed, similar briefs, story clusters, structured data, and real-time streaming.
Live Feed Updates
The intelligence feed now supports real-time updates. Toggle "Live updates" in the feed header and new briefs slide in automatically — no page refresh needed.
Similar Briefs, Story Clusters & Structured Data
Find related coverage with the new /similar endpoint, explore story clusters that group briefs by overlapping topics, and access structured quantitative data points (money, percentages, metrics) extracted automatically from every brief.
Full-Text Source Extraction & New API Endpoints
Pass include_full_text=true on /feed, /brief/:id, or /agent-feed to get raw article content from original sources — included free. New endpoints: /similar/:brief_id for similarity search, /clusters for story clustering, and /data for structured data point queries.
Upgraded Reading Experience
Article pages now use IBM Plex Sans for body text and IBM Plex Serif for headlines — optimized for long-form reading on dark backgrounds. Improved line-height, letter-spacing, and contrast for better readability across all brief and article pages.
Premium Intelligence Briefs
Generated briefs are now full intelligence reports — structured sections, deeper analysis, source quality ratings, and built-in accuracy safeguards. Every brief includes entity extraction, counter-arguments, and bias detection inline.
Richer Generate API Response
The generate endpoint now returns structured entities, bias analysis, source quality, related coverage, word count, processing time, and model attribution. All new fields are additive — existing integrations work unchanged.
Always-On Agent Intelligence
Our AI agents now run autonomously around the clock — continuously monitoring sources, detecting emerging stories, and self-healing when issues arise. Briefs are verified, scored, and published without human intervention. Zero downtime, zero babysitting.
OpenClaw: Entity Search, Trending Entities & Historical Search
Three new OpenClaw skill commands: /entities to search extracted entities (people, orgs, products) across briefs, /trending-entities for the most mentioned entities in the last 24 hours, and /historical for date-range brief search. Update with 'openclaw update polaris-report'.
Billing System Hardening
Improved checkout reliability, spending cap enforcement, and webhook handling. Checkout now requires authentication for added security.
Improved Reliability & Uptime
Briefs now continue to be generated with no downtime or interruption, even during maintenance windows. Improved reliability across the entire platform.
Entity Search & Trending Entities
New endpoints to search extracted entities across all briefs: /entities (search by name/type), /entities/:name/briefs (briefs mentioning an entity), and /entities/trending (top entities in last 24h). All briefs now include structured entity data with names, types, tickers, roles, and sentiment.
Historical Search
New /historical endpoint for date-range search with filters for category, entity, sentiment, and impact score. Existing /search endpoint now supports optional from/to date parameters.
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 month, then $0.006 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.
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.
Frontend Performance Optimizations
Reduced unnecessary re-renders, lazy-loaded heavy components, and added loading skeletons across all vertical pages for smoother navigation.
OpenClaw Skill Package
Install polaris-report via OpenClaw to get verified intelligence in any agent or chat platform. Ten slash commands: /news, /brief, /search, /trending, /entities, /trending-entities, /historical, /similar, /clusters, and /data.
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.
Compare View
Compare outlet coverage at /compare. See political lean, framing differences, loaded language, and verified facts across outlets.
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.
JavaScript & Python SDKs
Official SDKs now available: polaris-news-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 (Scale).
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 monthly 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 monthly limits: Free 1,000/mo, Builder 5,000/mo, Startup 15,000/mo, Growth 40,000/mo, Scale 100,000/mo. Per-minute rate limits for burst protection. 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.