Cloud Natural Language API

Name: Cloud Natural Language API API
Brand: Cloud Natural Language API
Availability: InStock

✓ Official Vendor SpecAI/MLLanguage Modelsoauth25 EndpointsREST

For Agents

Run sentiment, entity, syntax, classification, and moderation analysis on text or HTML documents using Google's pretrained NLP models. Useful for content tagging and review pipelines.

Quickstart

Get started with Cloud Natural Language API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"analyze sentiment of a text document"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with Cloud Natural Language API API.

Extract named entities such as people, places, and organizations from a document

Score document- and sentence-level sentiment from -1 to +1 with magnitude

Classify a document into Google's content taxonomy of over 1000 topics

Detect harmful content categories such as violence and harassment in user text

GET STARTED

Start building with Cloud Natural Language API API

Explore with Jentic

View OpenAPI Document

Use for: Analyze the sentiment of a customer review, Extract company and person names from a news article, Classify a blog post into Google's content taxonomy, I want to moderate user-submitted text for harmful content

Not supported: Does not generate text, translate languages, transcribe audio, or train custom models — use only for sentiment, entity, syntax, classification, and moderation analysis on existing text.

The Cloud Natural Language API applies Google's pretrained NLP models to plain text and HTML documents and returns structured analysis: named entities, document and sentence-level sentiment, syntactic annotation, content classification into a 1000+ category taxonomy, and content moderation labels. It is callable on text up to 1 MB per request and supports multiple languages depending on the feature. The v2 endpoints replace the older analyzeEntitySentiment and analyzeSyntax features with a streamlined annotateText combination call.

Use Cases

Patterns agents use Cloud Natural Language API API for, with concrete tasks.

★ Customer feedback sentiment analysis

Support and product teams pipe inbound feedback — reviews, survey responses, support tickets — into POST /v2/documents:analyzeSentiment to score overall and per-sentence sentiment. The score and magnitude let an agent prioritise strongly negative messages and route them to the right team without keyword rules.

Send a 500-word product review to /v2/documents:analyzeSentiment with type=PLAIN_TEXT and return documentSentiment.score and per-sentence sentiment.

Entity tagging for content systems

Newsrooms and CMS platforms tag articles by the people, places, and organizations mentioned in them. POST /v2/documents:analyzeEntities returns each entity with type, salience, and mentions, which an agent can use to build topic pages and recommendation links without manual tagging.

Send an article body to /v2/documents:analyzeEntities and return the top 10 entities by salience with their types.

User-generated content moderation

Community platforms call POST /v2/documents:moderateText on each new post to score it across categories such as Toxic, Insult, Sexual, Violent, and Public Safety. The agent can auto-hide content above a threshold and queue borderline cases for human review.

Pass a forum post to /v2/documents:moderateText and block the post if any moderationCategory.confidence exceeds 0.7.

Topic classification for editorial routing

Editorial and ad-targeting systems route content based on what it is about. POST /v2/documents:classifyText returns categories from a 1000+ topic taxonomy with confidence scores, so an agent can decide that a post belongs to /Sports/Soccer/MLS rather than /Business.

Send an article to /v2/documents:classifyText and return the top 3 categories with confidence.

Multi-feature analysis through Jentic

An agent inspecting user content can call POST /v2/documents:annotateText through Jentic to run entity extraction, sentiment, and classification in a single request. Jentic surfaces the features object so the agent can toggle which annotations to run without reading the full v2 reference.

Run google_language_annotate_text on a comment with features.extractEntities=true, extractDocumentSentiment=true, classifyText=true and return the combined result.

Key Endpoints

5 endpoints — the cloud natural language api applies google's pretrained nlp models to plain text and html documents and returns structured analysis: named entities, document and sentence-level sentiment, syntactic annotation, content classification into a 1000+ category taxonomy, and content moderation labels.

METHOD

PATH

DESCRIPTION

POST

/v2/documents:analyzeSentiment

Score document and per-sentence sentiment

POST

/v2/documents:analyzeEntities

Extract named entities with type and salience

POST

/v2/documents:classifyText

Classify a document into Google's content taxonomy

POST

/v2/documents:moderateText

Score harmful content categories on a document

POST

/v2/documents:annotateText

Run multiple analysis features in one call

POST

/v2/documents:analyzeSentiment

Score document and per-sentence sentiment

POST

/v2/documents:analyzeEntities

Extract named entities with type and salience

POST

/v2/documents:classifyText

Classify a document into Google's content taxonomy

POST

/v2/documents:moderateText

Score harmful content categories on a document

POST

/v2/documents:annotateText

Run multiple analysis features in one call

Why though Jentic?

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

Credential isolation

Google Cloud service account keys are stored encrypted in the Jentic vault. Agents receive a short-lived OAuth 2.0 access token scoped to cloud-language at call time, and the private key never enters the agent context.

Intent-based discovery

Agents search Jentic for intents like 'analyze sentiment of text' or 'classify content into topics' and Jentic returns the matching /v2/documents operation with the document and features schema already filled in.

Time to first call

Direct integration: 2-4 hours to set up auth, build the document payload, and parse each feature's response shape. Through Jentic: under 15 minutes — search, load, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Complementary

Cloud Translation API

Translation converts text between languages; Natural Language analyses meaning

Pair them: translate non-English content to English first, then run sentiment and classification.

Complementary

Knowledge Graph Search API

Knowledge Graph resolves entity names to canonical IDs; Natural Language extracts the names

Use Natural Language to extract entities then Knowledge Graph to resolve each surface form to a canonical entity.

Alternative

OpenAI API

OpenAI's chat completion can perform sentiment, entity, and classification via prompts; Natural Language returns structured output from a pretrained pipeline

Choose OpenAI when the agent needs flexible prompting and few-shot tasks; choose Natural Language when it needs predictable, billable, structured NLP output.

FAQs

Specific to using Cloud Natural Language API API through Jentic.

What authentication does the Cloud Natural Language API use?

OAuth 2.0 with the https://www.googleapis.com/auth/cloud-language or cloud-platform scope. A Google Cloud service account is the typical credential. Through Jentic the service account JSON sits in the encrypted vault and a short-lived access token is injected at request time.

What languages does the Natural Language API support?

Sentiment and entity analysis support English, Spanish, French, German, Italian, Japanese, Korean, Portuguese, Chinese (simplified and traditional), and Russian. Classification supports English, French, German, Italian, Japanese, Korean, Portuguese, and Spanish. Moderation currently supports English only.

What are the rate limits for the Natural Language API?

Default quota is 600 requests per minute per project, with each request limited to 1 MB of text. Pricing is per 1,000 characters and varies by feature — analyzeEntities and analyzeSentiment are billed separately even when combined in annotateText.

How do I run sentiment analysis through Jentic?

Run jentic search 'analyze sentiment of text' to find POST /v2/documents:analyzeSentiment, jentic load for the document schema, then jentic execute with body {"document": {"type": "PLAIN_TEXT", "content": "..."}} and read documentSentiment.score from the response.

Can I run multiple features in one call?

Yes. POST /v2/documents:annotateText accepts a features object — set extractEntities, extractDocumentSentiment, classifyText, and moderateText to true and the response includes each section. Each feature is billed independently.

Is the Cloud Natural Language API free?

There is a free tier of 5,000 units per feature per month. Beyond that, pricing is roughly $1-$2 per 1,000 units for sentiment, entities, and syntax, with classification and moderation slightly higher. Each unit is 1,000 characters.