# Content Understanding API

> Content Understanding API on Apizie: 15 endpoints (Get the result of an analysis operation., Mark the result of an analysis operation for deletion., Get a file associated with the result of an analysis operation., List analyzers., …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/cloud:azure-ai-content-understanding/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:azure-ai-content-understanding`
- Category: Cloud
- Status: byok
- Source: https://learn.microsoft.com/rest/api/azure/
- Page: https://apizie.tech/api/cloud/azure-ai-content-understanding
- OpenAPI: https://apizie.tech/api/cloud/azure-ai-content-understanding/openapi.json

The Content Understanding service extracts content and fields from multimodal input.

## Endpoints

### Get the result of an analysis operation.
`GET https://apizie.tech/v1/cloud:azure-ai-content-understanding/content-analyzers-get-result` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | yes | Content Understanding service endpoint. |
| api-version | string | no | The API version to use for this operation. |
| operationId | string | yes | The unique ID of the operation. |

### Mark the result of an analysis operation for deletion.
`POST https://apizie.tech/v1/cloud:azure-ai-content-understanding/content-analyzers-delete-result` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | yes | Content Understanding service endpoint. |
| api-version | string | no | The API version to use for this operation. |
| operationId | string | yes | Operation identifier. |

### Get a file associated with the result of an analysis operation.
`GET https://apizie.tech/v1/cloud:azure-ai-content-understanding/content-analyzers-get-result-file` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | yes | Content Understanding service endpoint. |
| api-version | string | no | The API version to use for this operation. |
| operationId | string | yes | Operation identifier. |
| path | string | yes | File path. |

### List analyzers.
`GET https://apizie.tech/v1/cloud:azure-ai-content-understanding/content-analyzers-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | yes | Content Understanding service endpoint. |
| api-version | string | no | The API version to use for this operation. |
| x-ms-client-request-id | string | no | An opaque, globally-unique, client-generated string identifier for the request. |

### Get analyzer properties.
`GET https://apizie.tech/v1/cloud:azure-ai-content-understanding/content-analyzers-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | yes | Content Understanding service endpoint. |
| api-version | string | no | The API version to use for this operation. |
| analyzerId | string | yes | The unique identifier of the analyzer. |
| x-ms-client-request-id | string | no | An opaque, globally-unique, client-generated string identifier for the request. |

### Create a new analyzer asynchronously.
`POST https://apizie.tech/v1/cloud:azure-ai-content-understanding/content-analyzers-create-or-replace` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | yes | Content Understanding service endpoint. |
| api-version | string | no | The API version to use for this operation. |
| analyzerId | string | yes | The unique identifier of the analyzer. |
| allowReplace | boolean | no | Allow the operation to replace an existing resource. |
| x-ms-client-request-id | string | no | An opaque, globally-unique, client-generated string identifier for the request. |
| body | object | yes | JSON request body |

### Update analyzer properties.
`POST https://apizie.tech/v1/cloud:azure-ai-content-understanding/content-analyzers-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | yes | Content Understanding service endpoint. |
| api-version | string | no | The API version to use for this operation. |
| analyzerId | string | yes | The unique identifier of the analyzer. |
| x-ms-client-request-id | string | no | An opaque, globally-unique, client-generated string identifier for the request. |
| body | object | yes | JSON request body |

### Delete analyzer.
`POST https://apizie.tech/v1/cloud:azure-ai-content-understanding/content-analyzers-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | yes | Content Understanding service endpoint. |
| api-version | string | no | The API version to use for this operation. |
| analyzerId | string | yes | The unique identifier of the analyzer. |
| x-ms-client-request-id | string | no | An opaque, globally-unique, client-generated string identifier for the request. |

### Extract content and fields from input.
`POST https://apizie.tech/v1/cloud:azure-ai-content-understanding/content-analyzers-analyze` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | yes | Content Understanding service endpoint. |
| api-version | string | no | The API version to use for this operation. |
| analyzerId | string | yes | The unique identifier of the analyzer. |
| stringEncoding | string | no | The string encoding format for content spans in the response. Possible values are 'codePoint', 'utf16', and `utf8`. Default is… |
| processingLocation | string | no | The location where the data may be processed. Defaults to global. |
| x-ms-client-request-id | string | no | An opaque, globally-unique, client-generated string identifier for the request. |
| body | object | yes | JSON request body |

### Extract content and fields from input.
`POST https://apizie.tech/v1/cloud:azure-ai-content-understanding/content-analyzers-analyze-binary` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | yes | Content Understanding service endpoint. |
| api-version | string | no | The API version to use for this operation. |
| analyzerId | string | yes | The unique identifier of the analyzer. |
| stringEncoding | string | no | The string encoding format for content spans in the response. Possible values are 'codePoint', 'utf16', and `utf8`. Default is… |
| processingLocation | string | no | The location where the data may be processed. Defaults to global. |
| range | string | no | Range of the input to analyze (ex. `1-3,5,9-`). Document content uses 1-based page numbers, while audio visual content uses integer… |
| x-ms-client-request-id | string | no | An opaque, globally-unique, client-generated string identifier for the request. |
| body | object | yes | JSON request body |

### Create a copy of the source analyzer to the current location.
`POST https://apizie.tech/v1/cloud:azure-ai-content-understanding/content-analyzers-copy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | yes | Content Understanding service endpoint. |
| api-version | string | no | The API version to use for this operation. |
| analyzerId | string | yes | The unique identifier of the analyzer. |
| allowReplace | boolean | no | Allow the operation to replace an existing resource. |
| x-ms-client-request-id | string | no | An opaque, globally-unique, client-generated string identifier for the request. |
| body | object | yes | JSON request body |

### Get authorization for copying this analyzer to another location.
`POST https://apizie.tech/v1/cloud:azure-ai-content-understanding/content-analyzers-grant-copy-authorization` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | yes | Content Understanding service endpoint. |
| api-version | string | no | The API version to use for this operation. |
| analyzerId | string | yes | The unique identifier of the analyzer. |
| x-ms-client-request-id | string | no | An opaque, globally-unique, client-generated string identifier for the request. |
| body | object | yes | JSON request body |

### Get the status of an analyzer creation operation.
`GET https://apizie.tech/v1/cloud:azure-ai-content-understanding/content-analyzers-get-operation-status` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | yes | Content Understanding service endpoint. |
| api-version | string | no | The API version to use for this operation. |
| analyzerId | string | yes | The unique identifier of the analyzer. |
| operationId | string | yes | The unique ID of the operation. |

### Return default settings for this Content Understanding resource.
`GET https://apizie.tech/v1/cloud:azure-ai-content-understanding/content-analyzers-get-defaults` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | yes | Content Understanding service endpoint. |
| api-version | string | no | The API version to use for this operation. |

### Update default settings for this Content Understanding resource.
`POST https://apizie.tech/v1/cloud:azure-ai-content-understanding/content-analyzers-update-defaults` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | yes | Content Understanding service endpoint. |
| api-version | string | no | The API version to use for this operation. |
| body | object | yes | JSON request body |

## Example
```
curl "https://apizie.tech/v1/cloud:azure-ai-content-understanding/content-analyzers-get-result" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Content Understanding API?
Create a free Apizie key, then send GET https://apizie.tech/v1/cloud:azure-ai-content-understanding/content-analyzers-get-result with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Content Understanding API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Content Understanding itself also needs your own key from azure.com.

### Can AI agents use the Content Understanding API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:azure-ai-content-understanding.

### What is the status of the Content Understanding API?
Needs your own provider key (bring your own key)