Google Perspective Comment Analyzer API

Name: Perspective Comment Analyzer API
Brand: Perspective Comment Analyzer API
Availability: InStock

✓ Official Vendor SpecAI/MLMl Inferenceoauth22 Endpoints

Install Jentic One Beta

Connect the Perspective Comment Analyzer API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Perspective Comment Analyzer API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Perspective Comment Analyzer API.

Score a comment on TOXICITY, SEVERE_TOXICITY, INSULT, THREAT, and PROFANITY attributes

Request span-level annotations for parts of a comment that triggered each score

Submit moderator-corrected scores back to the model via comments:suggestscore

GET STARTED

Start building with Perspective Comment Analyzer API

Explore with Jentic

View OpenAPI Document

For Agents

Score user-generated text for toxicity, insult, threat, and related attributes, and submit human-labeled feedback to improve the model. Lets agents triage harmful content in moderation pipelines.

Use for: I need to score a comment for toxicity, Check whether a message looks like an insult or threat, Analyze a forum post for severe toxicity, Submit a moderator's score back to Perspective for training

Not supported: Does not block, delete, or rewrite content, identify users, or detect spam beyond its trained attributes - use for scoring text on toxicity-related attributes only.

Use Cases

Patterns agents use Perspective Comment Analyzer API for, with concrete tasks.

★ Pre-Publish Comment Moderation

Score every new comment with the analyze endpoint before it is shown to the public. Comments with toxicity probability above a threshold are routed to a human moderator queue, while clearly safe comments are published immediately. This lets community sites keep submission latency low without exposing readers to abuse.

Call comments:analyze with the comment text and the TOXICITY attribute, and route any comment with summaryScore.value > 0.7 to manual review

Real-Time Chat Filtering

Score chat messages as they are sent so the platform can soft-block or flag harmful content before it reaches recipients. Perspective returns per-attribute probabilities for TOXICITY, INSULT, THREAT, and PROFANITY in a single call, letting product teams build a tiered response (warn, hide, escalate) without retraining their own models.

Score every inbound chat message for INSULT and THREAT and hide messages where either summaryScore exceeds 0.85

Active Learning Feedback Loop

When human moderators override an automated decision, send their corrected score back to Perspective via comments:suggestscore. This signal is used by Jigsaw to improve future model versions on the attributes that matter most to your community, which keeps moderation quality high as language norms shift over time.

When a moderator marks an automated TOXICITY=0.9 decision as incorrect, call comments:suggestscore with the moderator's score of 0.1

Agent-Mediated Trust And Safety

An AI agent built into a community platform can call Perspective via Jentic to triage every report or new post, escalating only borderline cases to humans. Because Jentic returns the analyze schema, the agent can ask for the exact attributes it cares about and act on the structured probabilities directly.

Use Jentic to call comments:analyze for each reported post requesting attributes TOXICITY, SEVERE_TOXICITY, INSULT, THREAT, and surface any post where any attribute exceeds 0.8

Key Endpoints

2 endpoints — the perspective comment analyzer api scores user-generated text on attributes such as toxicity, severe toxicity, insult, profanity, and threat.

METHOD

PATH

DESCRIPTION

POST

/v1alpha1/comments:analyze

Score a comment on the requested attributes

POST

/v1alpha1/comments:suggestscore

Submit a corrected score for a previously analyzed comment

POST

/v1alpha1/comments:analyze

Score a comment on the requested attributes

POST

/v1alpha1/comments:suggestscore

Submit a corrected score for a previously analyzed comment

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Your Perspective OAuth credential is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'score a comment for toxicity', and Jentic returns the matching Perspective operation with its input schema and supported attributes so the agent calls the right endpoint without browsing the reference docs.

Time to first call

FAQs

Specific to using Perspective Comment Analyzer API through Jentic.

What authentication does the Perspective Comment Analyzer API use?

It uses Google OAuth 2.0 with the cloud-platform scope, and Perspective additionally accepts API keys at the request level. Through Jentic the credential is stored encrypted in your Jentic One instance and the agent only sees scoped tokens at execution time.

Which attributes can the API score a comment on?

Common attributes include TOXICITY, SEVERE_TOXICITY, INSULT, IDENTITY_ATTACK, THREAT, and PROFANITY, with additional experimental attributes available for English text. The full list is supplied per-request via requestedAttributes in the comments:analyze body.

What are the rate limits for the Perspective API?

Perspective enforces a default per-project quota of one query per second, with higher limits available on request through the Perspective developer site. Batch your moderation calls and cache scores for repeated text to stay under the QPS ceiling.

How do I score a comment through Jentic?

Search Jentic for 'score comment for toxicity', load the comments:analyze schema, and execute the call against /v1alpha1/comments:analyze with the comment text and a requestedAttributes map. Jentic returns the schema so the agent fills only the attributes it cares about.

Is the Perspective API free?

Yes. Perspective is provided free of charge by Jigsaw within the published quotas. Higher-volume access requires a request through the Perspective developer portal.

Can I submit moderator decisions back to improve the model?

Yes. Call /v1alpha1/comments:suggestscore with the original comment, the requested attributes, and the corrected score from your moderator. Jigsaw uses these signals to retrain and improve future model versions.

Can I limit what my agent is allowed to do with the Perspective Comment Analyzer API?

Yes. Because you self-host Jentic One, your own rules decide which Perspective operations and credentials the agent may use. You can allow it to score comments on attributes like toxicity, insult, and threat via comments:analyze while withholding comments:suggestscore, so the agent cannot submit corrected scores back to the model unless you add that operation. Since Perspective takes the text to score in the request body rather than a resource id in the path, you scope access at the operation level and the stored OAuth credential is injected only at execution time.

Google Perspective Comment Analyzer API

Connect the Perspective Comment Analyzer API to your agent

Capabilities

Start building with Perspective Comment Analyzer API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs