Method: documents.analyzeEntities

HTTP request
Request body
- JSON representation
Response body
- JSON representation
Authorization scopes
Try it!

Finds named entities (currently proper names and common nouns) in the text along with entity types, salience, mentions for each entity, and other properties.

HTTP request

POST https://language.googleapis.com/v1/documents:analyzeEntities

The URL uses gRPC Transcoding syntax.

Request body

The request body contains data with the following structure:

JSON representation
{ "document" : { object ( `Document` ) } , "encodingType" : enum ( `EncodingType` ) }

Fields

Fields
`document`	`object ( Document )` Required. Input document.
`encoding Type`	`enum ( EncodingType )` The encoding type used by the API to calculate offsets.

document

object ( Document )

Required. Input document.

encoding  
Type

enum ( EncodingType )

The encoding type used by the API to calculate offsets.

Response body

The entity analysis response message.

If successful, the response body contains data with the following structure:

JSON representation
{ "entities" : [ { object ( `Entity` ) } ] , "language" : string }

Fields

Fields
`entities[]`	`object ( Entity )` The recognized entities in the input document.
`language`	`string` The language of the text, which will be the same as the language specified in the request or, if not specified, the automatically-detected language. See `Document.language` field for more details.

entities[]

object ( Entity )

The recognized entities in the input document.

language

string

The language of the text, which will be the same as the language specified in the request or, if not specified, the automatically-detected language. See Document.language field for more details.

Authorization scopes

Requires one of the following OAuth scopes:

https://www.googleapis.com/auth/cloud-language
https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview .