Skip to main content
GET
/
contents
/
v1
/
documents
/
{content_id}
/
annotated
Get annotated document
curl --request GET \
  --url https://api.bigdata.com/contents/v1/documents/{content_id}/annotated \
  --header 'X-API-KEY: <api-key>'
{
  "url": "https://content.bigdata.com/classified-documents/E0618D0E9D3A960C1731A620EDE56B5C.json?Expires=1770304237&Signature=abc123...&Key-Pair-Id=K34UQS1JQ2RLGM"
}

Authorizations

​
X-API-KEY
string
header
required

Your API key. Include it in every request as the X-API-KEY header. Create and manage keys in the Developer Platform.

Path Parameters

​
content_id
string
required

Content ID of the document (32-character uppercase hex string).

Pattern: ^[A-F0-9]{32}$
Example:

"E0618D0E9D3A960C1731A620EDE56B5C"

Response

The endpoint returns an object containing a pre-signed url. Perform a GET request on that URL to retrieve the annotated document in JSON format. The URL is valid for 24 hours; request a new one if needed.

​
url
string<uri>
required

Pre-signed URL that provides temporary access to the annotated document in JSON format. When you access the URL, you receive the complete document with structure: document (metadata), content (title and body blocks), profiling (processor timestamps), and analytics (document-level metrics, events array, entities array).

Example:

"https://content.bigdata.com/classified-documents/E0618D0E9D3A960C1731A620EDE56B5C.json?Expires=1770304237&Signature=abc123...&Key-Pair-Id=K34UQS1JQ2RLGM"

​
document
object

Returned by URL - Document metadata including source information, timestamps, and details.

​
content
object

Returned by URL - Document content including title, body blocks, entities, and sentences.

​
profiling
object

Returned by URL - Processor timestamps for collection.

​
analytics
object

Returned by URL - Document-level analytics, events array, and entities array.