This API provides **advanced sentiment analysis**, **emotion detection**, **language identification**, **sentiment scoring**, and **keyword extraction with sentiment** for any given text. It is ideal for analyzing reviews, social media posts, feedback, comments, and articles. ---

Getting Started

To begin using this API, follow these steps and make your first API call: **Subscribe to a plan:** Visit our Pricing page and subscribe to one of the plans. If you are just starting, you can subscribe to the free BASIC plan of the API (hard-limited and no credit card required). **Make your first API call:** Visit the RapidAPI Playground — the Sentiment Analysis endpoint should be selected and displayed on the main panel view. Enter a sample text and click the blue **“Test endpoint”** button. The JSON response will be displayed on the right panel. **Documentation and Resources:** Refer to the detailed endpoint descriptions, input parameters, and response examples provided in the Endpoints tab. Code snippets are available for popular programming languages including JavaScript, Python, Java, Shell, and more to help you quickly integrate the API. You should be good to go now! ---

Authentication

To authenticate with the API, send the **X-RapidAPI-Host** header along with the **X-RapidAPI-Key** header set to your RapidAPI App API Key (as shown in the endpoint Code Snippets). ---

Input Parameters

The following parameters are supported by the API (sent via **POST** request as JSON or form-data): **text** (required) The text content to analyze for sentiment, emotions, and language. Example: `I absolutely love this product, but the delivery was slow and frustrating.` ---

Response Structure

Here’s an example of a successful response: ``` { "success": true, "language": "English", "sentiment": "positive", "score": { "raw": 3, "normalized": 0.6 }, "metrics": { "strength_percent": 60, "sentiment_ratio": "5:2", "passion_percent": 42.85, "reach_percent": 78.57 }, "emotion": { "dominant": "happy", "distribution": { "happy": 4, "angry": 1, "sad": 0, "fear": 0, "surprise": 1 } }, "keywords_with_sentiment": { "love": "positive", "slow": "negative", "frustrating": "negative" }, "counts": { "positive": 5, "negative": 2, "total_words": 14 } } ``` ---

Response Fields Explained

**sentiment** Overall sentiment classification: `positive`, `negative`, or `neutral` **language** Automatically detected language (supports 50+ languages) **score.raw** Difference between positive and negative word counts **score.normalized** Normalized sentiment score between `-1` and `+1` **strength_percent** Intensity of sentiment based on emotional weight **sentiment_ratio** Positive to negative word ratio displayed as `positive:negative` (example: `5:2`) **passion_percent** Emotional density of the text **reach_percent** Vocabulary diversity and content reach score **emotion.dominant** Most dominant detected emotion **keywords_with_sentiment** Important keywords tagged with their sentiment ---

Endpoints

For detailed endpoint parameters, response fields, and live testing, please refer to the **Endpoints** section of this API. ---

Rate Limiting

Each subscription plan defines the maximum number of requests permitted per month, along with a rate limit expressed in RPS (Requests Per Second). All free plans (such as BASIC) are limited to **1000 requests per hour**, as required by RapidAPI. ---

Rate Limits Headers

All API responses include the following rate limit headers: **x-ratelimit-requests-limit:** Total number of requests allowed by your subscription. **x-ratelimit-requests-remaining:** Remaining requests before reaching the quota limit. **x-ratelimit-requests-reset:** Time in seconds until the quota resets. ---

Handling Limits

When rate limits are exceeded, the API will return a **429 Too Many Requests** error. ``` { "message": "Too many requests" } ``` Wait until the limit resets or upgrade your subscription plan for higher limits. ---

Code Examples

Code examples for JavaScript, Python, Java, Shell, and other popular languages are available in the **Endpoints** tab under **Code Snippets**. ---

Common HTTP Status Codes

**400 Bad Request:** Missing or invalid parameters **403 Forbidden:** Invalid API key or no active subscription **404 Not Found:** Invalid endpoint **429 Too Many Requests:** Rate limit exceeded **5XX Server Error:** Temporary server-side issue ---

Support

If you encounter any issues or need clarification, please contact us with the error code, message, and request context, and we will assist you promptly. ---

Contact Us

For custom plans, enterprise usage, or high-volume requests: **Email:** [alreadycoded@gmail.com](mailto:alreadycoded@gmail.com) **Website:** [https://www.alreadycoded.com](https://www.alreadycoded.com)