Watson Natural Language Understanding API
Overview
IBM Watson Natural Language Understanding (NLU) is a powerful AI-driven API that extracts semantic meaning from text, including sentiment, entities, keywords, categories, and emotion. It is built on IBM Cloud and supports multiple languages with enterprise-grade reliability. Developers use it to build smarter chatbots, content analyzers, and customer feedback tools.
Beginner Tip
Always specify the "features" object in your request body — without it the API returns an error. Start with just "sentiment" and "keywords" to understand the response structure before enabling all available features.
Available Data
Example Response
{
"status": "success",
"data": {
"result": "Data from Watson Natural Language Understanding",
"description": "Natural language processing for advanced text analysis",
"timestamp": "2025-01-15T10:00:00Z"
}
} Field Reference
sentiment.document.score Overall document sentiment score from -1 (negative) to 1 (positive) sentiment.document.label Human-readable sentiment label: "positive", "negative", or "neutral" keywords List of important keywords extracted from the text with relevance scores entities Named entities detected in the text, including type (Person, Organization, Location) and confidence categories Hierarchical content categories the text belongs to, with confidence scores language Detected or specified language of the analyzed text as an ISO 639-1 code Implementation Example
const url = "https://cloud.ibm.com/apidocs/natural-language-understanding/natural-language-understanding";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
headers: {
"Authorization": "Bearer YOUR_API_KEY"
}
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data); What Can You Build?
Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.
Common Errors & Troubleshooting
Matrix Score Breakdown
Partially tested on Apr 5, 2026
Technical Specifications
Related Tags
Alternatives to Watson Natural Language Understanding
Technical alternatives for different use cases.
IBM's NLP service with emotion and concept extraction
Pricing simplicity and free tier size
Emotion analysis and advanced concept tagging
Similar APIs
View All →apilayer languagelayer
apilayer languagelayer is a language detection API that identifies the language of any text across 173 supported languages.
Code Detection API
Code Detection API automatically identifies programming languages and detects code blocks within plain text or mixed content.
Semantria
Semantria is a powerful text analytics API by Lexalytics that provides sentiment analysis, entity extraction, and content categorization.
Tisane
Tisane is a text analytics API specialized in detecting abusive content, hate speech, and cybercrime in user-generated text.
Aylien Text Analysis
Aylien Text Analysis provides programmatic access to a collection of information retrieval and natural language apis via REST API.