apyhub
ARTIFICIAL INTELLIGENCE

AI Text Entity Sentiment Analysis API

Hosted on ApyHub

What it does

Entity Sentiment Analysis identifies sentiment for entities mentioned in a text input and returns the result under a google object when you request the Google service. Send plain text along with requested_service set to google, and include optional language settings if you need to guide the analysis.

Use it when you need to understand how people feel about specific brands, products, or public figures inside customer reviews, social posts, support tickets, or news coverage. The request schema also allows an optional google object with a key and google_language, plus optional encoding and language fields for text handling.

The response is intentionally compact: a top-level data object containing google when that service is requested. That makes it easy to plug into moderation flows, social listening dashboards, review analytics, or any pipeline that scores sentiment around named entities rather than whole documents.

If your application needs entity-level opinion signals without building your own NLP pipeline, Entity Sentiment Analysis gives you a focused interface for text-based sentiment analysis.

Provider (requested_service)Atoms
Google500
POST
Entity Sentiment Analysis
http://localhost:8080/apyhub/entity-sentiment-analysis
QUICKSTARTGUIDE

Quickstart

Analyze the sentiment of a piece of text with the Google service.

curl -X POST "http://localhost:8080/apyhub/entity-sentiment-analysis" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "I love R&B music. Marvin Gaye is the best. Whats Going On is one of my favorite songs. It was so sad when Marvin Gaye died.",
    "requested_service": "google",
    "google": {
        "key": "your-google-key"
    }
  }'

What you'll get back

Returns a JSON object with a data object. When requested_service is google, data.google contains the Google sentiment analysis result.

{
  "data": {
    "google": {}
  }
}
TRY ITLIVE · 500 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
body*
google

About this endpoint

What it does

Analyzes the sentiment of entities in the submitted text and returns a JSON object containing a data object with a google result when requested_service is google.

Request Body

ParameterTypeMandatoryDescription
textStringYesThe text to analyze.
requested_serviceENUMYesThe service to use. Allowed value: google.
googleObjectNoGoogle-specific settings. See schema for nested fields.
google.keyStringNoGoogle API key.
google.google_languageStringNoGoogle language code.
encodingStringNoText encoding.
languageStringNoLanguage code for the input text.

Response

Returns a JSON object with a required data object field. When requested_service is google, data.google is present as an object; the schema allows additional properties inside it.

ParameterTypeMandatoryDescription
dataObjectYesWrapper object for the analysis result.
data.googleObjectNoPresent when requested_service is google. The schema allows additional properties.

Body

Name
Type
Description
bodyREQUIRED
object
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.