Language Detection

Language Detection

What it does

Language Detection identifies the language of a text string and returns a structured result from the selected provider. Send plain text in body.text, and choose requested_service to use apyhub, azure, or google.

Use it when you need to route user content, label documents, or apply the right downstream NLP pipeline. A chat app can detect the language of an incoming message before translation; a content system can classify uploaded text before indexing or moderation.

The request schema also supports provider-specific credentials through body.azure and body.google when you want to call those services directly. The response wraps provider output under data.azure, data.apyhub, or data.google, so you can consume the result from the service you selected without guessing the response shape.

This is a lightweight text-analysis endpoint: you provide the text, and Language Detection returns the detected-language response from the chosen backend.

curl -X POST "https://api.eu.apyverse.com/apyhub/detect-language" \ -H "apy-token: $APY_TOKEN" \ -H "Content-Type: application/json" \ -d '{"text":"Bonjour tout le monde!","requested_service":"apyhub"}'

About this endpoint

What it does

Detects the language of the provided text and returns a JSON object containing provider-specific result objects under data. You can request detection through azure, google, or apyhub using requested_service.

Request Body

Parameter	Type	Mandatory	Description
text	String	Yes	The text to analyze for language detection.
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. See schema for nested fields.
requested_service	ENUM	No	Service to use for detection. Allowed values: `azure`, `google`, `apyhub`. Default: `apyhub`.

Response

Returns a JSON object with a data object field. Inside data, the schema declares three provider response objects: azure, apyhub, and google.

Parameter	Type	Mandatory	Description
data	Object	No	Wrapper object for provider-specific response payloads.
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

—

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