apyhub
ARTIFICIAL INTELLIGENCE

AI Text Entity Sentiment Analysis API

What it does

Entity Sentiment Analysis helps you send text and get entity-level sentiment results back through the Google service. It is built for cases where you need to know not just whether text is positive or negative, but how sentiment is attached to specific entities mentioned in that text.

Send a request body with text and requested_service, and optionally include language, encoding, and a google object with key and google_language. The input is plain text, so you can analyze reviews, social posts, support tickets, news mentions, or survey responses without pre-structuring the content first.

The response returns a data object with a google field when requested_service is google. Because the schema is flexible there, treat it as the analysis payload for the text you sent. Use it when you need entity-aware sentiment signals for dashboards, moderation workflows, market research, or triaging feedback by brand, product, or person.

Entity Sentiment Analysis fits into pipelines where text classification alone is not enough. You can feed it short comments or longer passages and use the returned analysis to group mentions, detect sentiment around named entities, or enrich downstream reporting.

POST
Entity Sentiment Analysis
https://api.eu.apyverse.com/apyhub/entity-sentiment-analysis

QUICKSTART

GUIDE

Quickstart

Analyze the sentiment of a short text using the Google service.

curl -X POST "https://api.eu.apyverse.com/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"
  }'

What you'll get back

Returns a JSON object with a data object field. When requested_service is google, data.google is present and contains the service-specific 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 text you send in the request body. The response is a JSON object with a data object that includes a google object when requested_service is google.

Request Body

ParameterTypeMandatoryDescription
textStringYesThe input text to analyze.
requested_serviceENUMYesService to use for the analysis. Allowed value: google.
googleObjectNoGoogle-specific configuration object. Contains optional key and google_language fields.
google.keyStringNoGoogle API key.
google.google_languageStringNoLanguage code for Google processing.
encodingStringNoText encoding.
languageStringNoLanguage code for the input text.

Response

Returns a JSON object with a required data object field. The data object may include a google object when requested_service is google.

ParameterTypeMandatoryDescription
dataObjectYesResponse container object. May include google when requested_service is google.
data.googleObjectNoPresent when requested_service is google. The schema does not define its internal fields.

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.