# Geneea Natural Language Processing API

> Geneea Natural Language Processing API on Apizie: 12 endpoints (Information about current user account, Performs text correction (diacritization) on the given document, Performs text correction (diacritization) on the given document, Performs named-entity recognition on the given document, …) 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/ai:geneea/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `ai:geneea`
- Category: Artificial Intelligence
- Status: byok
- Source: https://geneea.com
- Page: https://apizie.tech/api/ai/geneea
- OpenAPI: https://apizie.tech/api/ai/geneea/openapi.json

Authentication For all calls, supply your API key. Sign up to obtain the key . Our API supports both unencrypted (HTTP) and encrypted (HTTPS) protocols. However, for security reasons, we strongly encourage using only…

## Endpoints

### Information about current user account
`GET https://apizie.tech/v1/ai:geneea/get-info` (byok)

### Performs text correction (diacritization) on the given document
`GET https://apizie.tech/v1/ai:geneea/correction-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | no | document ID |
| text | string | no | raw document text |
| url | string | no | document URL |
| extractor | string | no | document extractor |
| language | string | no | document language |
| returnTextInfo | boolean | no |  |

### Performs text correction (diacritization) on the given document
`POST https://apizie.tech/v1/ai:geneea/correction-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Performs named-entity recognition on the given document
`GET https://apizie.tech/v1/ai:geneea/entities-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | no | document ID |
| text | string | no | raw document text |
| url | string | no | document URL |
| extractor | string | no | document extractor |
| language | string | no | document language |
| returnTextInfo | boolean | no |  |

### Performs named-entity recognition on the given document
`POST https://apizie.tech/v1/ai:geneea/entities-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Performs lemmatization on the given document
`GET https://apizie.tech/v1/ai:geneea/lemmatize-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | no | document ID |
| text | string | no | raw document text |
| url | string | no | document URL |
| extractor | string | no | document extractor |
| language | string | no | document language |
| returnTextInfo | boolean | no |  |

### Performs lemmatization on the given document
`POST https://apizie.tech/v1/ai:geneea/lemmatize-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Performs sentiment analysis on the given document
`GET https://apizie.tech/v1/ai:geneea/sentiment-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | no | document ID |
| text | string | no | raw document text |
| url | string | no | document URL |
| extractor | string | no | document extractor |
| language | string | no | document language |
| returnTextInfo | boolean | no |  |

### Performs sentiment analysis on the given document
`POST https://apizie.tech/v1/ai:geneea/sentiment-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Performs topic detection on the given document
`GET https://apizie.tech/v1/ai:geneea/topic-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | no | document ID |
| text | string | no | raw document text |
| url | string | no | document URL |
| extractor | string | no | document extractor |
| language | string | no | document language |
| returnTextInfo | boolean | no |  |

### Performs topic detection on the given document
`POST https://apizie.tech/v1/ai:geneea/topic-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Gets status of the Interpretor service
`GET https://apizie.tech/v1/ai:geneea/status` (byok)

## Example
```
curl "https://apizie.tech/v1/ai:geneea/get-info" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Geneea Natural Language Processing API?
Create a free Apizie key, then send GET https://apizie.tech/v1/ai:geneea/get-info with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

### Can AI agents use the Geneea Natural Language Processing 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 ai:geneea.

### What is the status of the Geneea Natural Language Processing API?
Needs your own provider key (bring your own key)