Entity Recognition — extract named entities from text

AI Text Entity Recognition API

What it does

Entity Recognition identifies named entities in text and returns the detected results through the provider you select: ApyHub, Google, or Azure. Send a text string, optionally include provider-specific credentials, and get entity analysis back in a structured response.

Use it when you need to extract people, organisations, places, or other referenced entities from user content, notes, support tickets, or documents that have already been converted to text. The request body accepts text, encoding, language, requested_service, and optional azure or google credential objects. That makes it easy to route the same input through your preferred NLP stack without changing your integration shape.

The response contains a data object with a service-specific object for azure, apyhub, or google, depending on which provider you request. Because the output is provider-specific, you can plug the result into downstream classification, enrichment, search indexing, or content analysis workflows without guessing at the schema.

Entity Recognition fits pipelines that need lightweight NLP around plain text: enrich CRM notes, detect mentions in article archives, or pre-process incoming messages before storage and routing.

curl -X POST "https://api.eu.apyverse.com/apyhub/recognize-entities-in-text" \ -H "apy-token: $APY_TOKEN" \ -H "Content-Type: application/json" \ -d '{"text":"Google was founded in 1998 by Larry Page and Sergey Brin.","requested_service":"apyhub"}'

About this endpoint

What it does

Recognizes entities in the provided text and returns a JSON object containing provider-specific result data under data. You can optionally supply custom Azure or Google credentials, choose the requested service, and set language/encoding parameters.

Request Body

Parameter	Type	Mandatory	Description
text	String	Yes	The text to analyze for entity recognition.
azure	Object	No	Custom credentials for Azure services.
azure.key	String	No	Azure subscription key.
azure.region	String	No	Azure service region.
azure.endpoint	String	No	Azure endpoint URL.
azure.account_id	String	No	Azure account ID.
azure.access_token	String	No	OAuth access token for Azure service.
google	Object	No	Custom credentials for Google services.
google.google_language	String	No	Target language locale.
google.google_credential_json	Object	No	Google service account credential JSON object. See schema for nested fields.
encoding	String	No	Text encoding.
language	String	No	Language of the input text.
requested_service	ENUM	No	Which service to use. Allowed values: `azure`, `google`, `apyhub`. Default: `apyhub`.

Response

Returns a JSON object with a data object field. The data object may include azure, apyhub, and google fields, each representing the response object from the corresponding provider.

Parameter	Type	Mandatory	Description
data	Object	No	Container for provider-specific response objects.
data.azure	Object	No	Response object from Microsoft Azure Cognitive Services.
data.apyhub	Object	No	Response object from ApyHub language tools.
data.google	Object	No	Response object from Google Cloud NLP API.

Body

Name

Type

Description

bodyREQUIRED

object

—

AI Text Entity Recognition API

What it does

QUICKSTART

Quickstart

What you'll get back

About this endpoint

What it does

Request Body

Response

Body

Errors any endpoint can return