Google Perspective API Sunset: Migration Guide for Forums

In March 2026, Google announced the sunset of Perspective API, set for late 2026. For the thousands of forums, comment systems, and publishing platforms that rely on it, this means finding a Perspective API alternative before the deadline.

This guide explains what's changing, why it matters, and how to migrate to OpenModeration with minimal disruption.

What's happening and when

Perspective API was one of the first widely available toxicity detection APIs. Launched by Jigsaw (a Google incubator) in 2017, it powered moderation for platforms like The New York Times, Disqus, and countless forum communities.

Google's sunset timeline has three phases:

• Mid 2026: No new API keys issued. Existing keys continue working.
• Late 2026: API becomes read-only. New moderation requests return errors.
• Early 2027: Complete shutdown. All endpoints return 410 Gone.

Why Perspective API is shutting down

Google cited two reasons in their announcement. First, the toxicity detection landscape has matured significantly since 2017. There are now dozens of provider options ranging from OpenAI to HuggingFace to Mistral. Second, Perspective API's attribute-based scoring model is increasingly out of step with how modern moderation works — most platforms now want more nuanced, context-aware decisions.

What this means for your forum

If you're using Perspective API today, your moderation pipeline will break when the shutdown happens. Comments and posts that rely on automated toxicity scoring will go unmoderated. You'll see one of three outcomes depending on how deeply you've integrated:

• Direct integration: If your app calls Perspective API directly, requests will fail. Your moderation queue goes dark.
• Through a middleware: If you use a moderation platform that wraps Perspective, check if they have a migration path.
• Via a social connector: Some social management tools use Perspective for comment filtering. Verify their plan.

Evaluating Perspective API alternatives

Here's what to look for in a replacement:

• Category coverage: Perspective detects toxicity, severe toxicity, identity attack, insult, profanity, threat, and sexually explicit. Your replacement should cover these categories and more.
• Multi-provider support: Relying on a single provider means you repeat this migration next time they change strategy. A unified API lets you switch with zero code changes.
• Latency: Forum moderation needs to happen before content appears. Aim for sub-second response times.
• Data control: If you process EU user content, GDPR matters. Self-hosted options avoid sending data to third parties.

Migration checklist

Follow these steps for a smooth Perspective API migration:

1. Audit your current usage. Count daily API calls, identify which categories you use, and measure your latency requirements. This gives you a baseline for the new setup.
2. Choose a replacement architecture. A unified moderation platform like OpenModeration lets you keep your integration stable even if you change providers later.
3. Map categories. Map your existing Perspective categories to the equivalent in your new provider. For example, Perspective's TOXICITY maps to categories like hate and harassment in most modern systems.
4. Retune thresholds. Different providers score differently. Run both systems in parallel for a week to calibrate your thresholds.
5. Update your integration. Replace your Perspective API call with the new API endpoint. With OpenModeration, this is a single POST /v1/moderations call.
6. Cut over. Point production traffic to the new system. Keep Perspective as a fallback for the transition period.

Migrating to OpenModeration

OpenModeration is the most straightforward Perspective API migration path. It provides a single API that routes to the best provider for each request. You can start with one provider and switch without changing code.

Here's what a migration looks like with OpenModeration:

Before (Perspective API): Your code makes a direct call to commentanalyzer.googleapis.com with a specific API key. You get back attribute scores. You hard-code thresholds. Changing providers means rewriting this integration.

After (OpenModeration): Your code calls POST /v1/moderations with the content text. OpenModeration routes to the configured provider, normalizes the response, and returns a consistent format. To change providers, you update a config file. No code changes needed.

What you gain beyond the migration

Migrating away from Perspective API is a forced upgrade. OpenModeration gives you capabilities that Perspective never had:

• Action Engine: Define rules that take action automatically. "If hate score > 0.8, hide and flag for review." No custom code.
• Audit trail: Every moderation decision is logged with full context. Exportable for compliance reporting.
• Analytics: Dashboard showing moderation volume, flagged rates, provider performance, and category breakdowns.
• DSA readiness: The audit logs and transparency data you need for EU Digital Services Act compliance.

Timeline and next steps

Google's Perspective API sunset deadline is end of 2026. The earlier you start your Perspective API migration, the more time you have to calibrate thresholds and test in production. We recommend beginning the process at least 90 days before your target cutover date.

For a complete guide to setting up OpenModeration, visit our documentation. Your first provider integration takes about 30 minutes.