> This page is for Analytics API.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://documentation.babelstreet.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://documentation.babelstreet.com/_mcp/server.

> All input parameters, including the text being analyzed and options, are defined in the request body.

| Parameter Name | Type   | Description               |
| -------------- | ------ | ------------------------- |
| content        | string | Text to process           |
| contentUri     | string | URI to accessbile content |
| language       | string | ISO 639 language code     |

> content and contentUri are mutually exclusive; only one can be specified per call.

The text being analyzed can be provided either as a string of text, a file, or the contents of a web page, specified by a URI.

To specify a stirng of text or a file, use the `content` parameter:

```
"content": "The Securities and Exchange Commission today announced the leadership \
of the agency’s trial unit.  Bridget Fitzpatrick has been named Chief Litigation Counsel \
of the SEC and David Gottesman will continue to serve as the agency’s Deputy Chief Litigation \
Counsel. Since December 2016, Ms. Fitzpatrick and Mr. Gottesman have served as Co-Acting Chief \
Litigation Counsel.  In that role, they were jointly responsible for supervising the trial unit \
at the agency’s Washington D.C. headquarters as well as coordinating with litigators in the SEC’s \
11 regional offices around the country." 
```

## Processing Local files

This cURL example assumes you have a file
input.txt in the directory Users/user with
your input data.

```
curl -H POST \ 
   -H "X-BabelStreetAPI-Key: your_api_key"\ 
   -F content=@/Users/user/input.txt \ 
   -F request='{"options": {"multilingual": true}}';\
type=application/json \
"https://analytics.babelstreet.com/rest/v1/language"
```

## Processing URIs

The text or document being analyzed can be contained in a website, accessed through a URI. Processing URI content is supported by submitting contentUri in your requests instead of content.

This procedure is available for all the text analtyics endpoints.

* contentUri must be a valid HTTP, HTTPS, or FTP URL
* Supported MIME types include text and HTML.
* The URL must be publicly accessible from the internet.
* No authentication is supported.
* No cookies or other persistence mechanism is supported.
* Page content (HTML) dynamically generated by JavaScript cannot be downloaded.
* Sites that deny programmatic (without a real browser controlled by an end user) requests cannot be downloaded.

```
curl -s -X POST \
    -H "X-BabelStreetAPI-Key: your_api_key" \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    -H "Cache-Control: no-cache" \
    -d '{"contentUri": "https://www.sec.gov/news/press-release/2017-161"
} }' \
    "https://analytics.babelstreet.com/rest/v1/entities"
```