# Semantria API

> Semantria API on Apizie: 41 endpoints (Retrieve blacklisted items, Add items to blacklist, Update items in blacklist, Remove items from blacklist, …) returned as clean JSON through one API key. 41 endpoints are live now. Call it over REST at https://apizie.tech/v1/social-media:semantria/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `social-media:semantria`
- Category: Social Media
- Status: live
- Source: https://semantria.com
- Page: https://apizie.tech/api/social-media/semantria
- OpenAPI: https://apizie.tech/api/social-media/semantria/openapi.json

Semantria applies Text and Sentiment Analysis to tweets, facebook posts, surveys, reviews or enterprise content.

## Endpoints

### Retrieve blacklisted items
`GET https://apizie.tech/v1/social-media:semantria/get-blacklist`

| Parameter | Type | Required | Description |
|---|---|---|---|
| config_id | string | no | Identifier of configuration blacklist linked to. |
| content_type | string | yes |  |

### Add items to blacklist
`POST https://apizie.tech/v1/social-media:semantria/add-blacklist`

| Parameter | Type | Required | Description |
|---|---|---|---|
| config_id | string | no | Identifier of configuration blacklist linked to. |
| content_type | string | yes |  |
| body | object | yes | JSON request body |

### Update items in blacklist
`POST https://apizie.tech/v1/social-media:semantria/update-blacklist`

| Parameter | Type | Required | Description |
|---|---|---|---|
| config_id | string | no | Identifier of configuration blacklist linked to. |
| content_type | string | yes |  |
| body | object | yes | JSON request body |

### Remove items from blacklist
`POST https://apizie.tech/v1/social-media:semantria/delete-blacklist-items`

| Parameter | Type | Required | Description |
|---|---|---|---|
| config_id | string | no | Identifier of configuration blacklist items linked to. |
| content_type | string | yes |  |
| body | object | yes | JSON request body |

### Retrieve user categories
`GET https://apizie.tech/v1/social-media:semantria/get-categories`

| Parameter | Type | Required | Description |
|---|---|---|---|
| config_id | string | no | Identifier of configuration user categories linked to. |
| content_type | string | yes |  |

### Add user categories
`POST https://apizie.tech/v1/social-media:semantria/add-categories`

| Parameter | Type | Required | Description |
|---|---|---|---|
| config_id | string | no | Identifier of configuration user categories linked to. |
| content_type | string | yes |  |
| body | object | yes | JSON request body |

### Updates user categories
`POST https://apizie.tech/v1/social-media:semantria/update-categories`

| Parameter | Type | Required | Description |
|---|---|---|---|
| config_id | string | no | Identifier of configuration user categories linked to. |
| content_type | string | yes |  |
| body | object | yes | JSON request body |

### Remove user categories
`POST https://apizie.tech/v1/social-media:semantria/delete-categories`

| Parameter | Type | Required | Description |
|---|---|---|---|
| config_id | string | no | Identifier of configuration user categories linked to. |
| content_type | string | yes |  |
| body | object | yes | JSON request body |

### Queue collection for analysis
`POST https://apizie.tech/v1/social-media:semantria/queue-collection`

| Parameter | Type | Required | Description |
|---|---|---|---|
| config_id | string | no | Identifier of configuration used for analysis. |
| content_type | string | yes |  |
| body | object | yes | JSON request body |

### Retrieve collections analysis
`GET https://apizie.tech/v1/social-media:semantria/retrieve-processed-collections`

| Parameter | Type | Required | Description |
|---|---|---|---|
| config_id | string | no | Identifier of configuration used for analysis. |
| content_type | string | yes |  |

### Retrieve collection analysis or its status in queue
`GET https://apizie.tech/v1/social-media:semantria/receive-collection-analytic-data`

| Parameter | Type | Required | Description |
|---|---|---|---|
| config_id | string | no | Identifier of configuration used for analysis. |
| collection_id | string | yes | Collection ID |
| content_type | string | yes |  |

### Cancel collection analysis
`POST https://apizie.tech/v1/social-media:semantria/cancel-collection`

| Parameter | Type | Required | Description |
|---|---|---|---|
| config_id | string | no | Identifier of configuration used for analysis. |
| collection_id | string | yes | Collection ID |
| content_type | string | yes |  |

### Retrieve user configurations
`GET https://apizie.tech/v1/social-media:semantria/get-configurations`

| Parameter | Type | Required | Description |
|---|---|---|---|
| content_type | string | yes |  |

### Create user configurations
`POST https://apizie.tech/v1/social-media:semantria/add-configurations`

| Parameter | Type | Required | Description |
|---|---|---|---|
| content_type | string | yes |  |
| body | object | yes | JSON request body |

### Update user configurations
`POST https://apizie.tech/v1/social-media:semantria/update-configurations`

| Parameter | Type | Required | Description |
|---|---|---|---|
| content_type | string | yes |  |
| body | object | yes | JSON request body |

### Remove user configurations
`POST https://apizie.tech/v1/social-media:semantria/delete-configurations`

| Parameter | Type | Required | Description |
|---|---|---|---|
| content_type | string | yes |  |
| body | object | yes | JSON request body |

### Queue document for analysis
`POST https://apizie.tech/v1/social-media:semantria/queue-document`

| Parameter | Type | Required | Description |
|---|---|---|---|
| config_id | string | no | Identifier of configuration used for analysis. |
| content_type | string | yes |  |
| body | object | yes | JSON request body |

### Queue batch of documents for analysis
`POST https://apizie.tech/v1/social-media:semantria/queue-batch-of-documents`

| Parameter | Type | Required | Description |
|---|---|---|---|
| config_id | string | no | Identifier of configuration used for analysis. |
| content_type | string | yes |  |
| body | object | yes | JSON request body |

### Retrieve documents analysis
`GET https://apizie.tech/v1/social-media:semantria/retrieve-processed-documents`

| Parameter | Type | Required | Description |
|---|---|---|---|
| config_id | string | no | Identifier of configuration used for analysis. |
| content_type | string | yes |  |

### Retrieve document analysis or its status in queue
`GET https://apizie.tech/v1/social-media:semantria/receive-document-analytic-data`

| Parameter | Type | Required | Description |
|---|---|---|---|
| config_id | string | no | Identifier of configuration used for analysis. |
| document_id | string | yes | Document ID |
| content_type | string | yes |  |

### Cancel document analysis
`POST https://apizie.tech/v1/social-media:semantria/cancel-document`

| Parameter | Type | Required | Description |
|---|---|---|---|
| config_id | string | no | Identifier of configuration used for analysis. |
| document_id | string | yes | Document ID |
| content_type | string | yes |  |

### Retrieve user entities
`GET https://apizie.tech/v1/social-media:semantria/get-entities`

| Parameter | Type | Required | Description |
|---|---|---|---|
| config_id | string | no | Identifier of configuration user entities linked to. |
| content_type | string | yes |  |

### Add user entities
`POST https://apizie.tech/v1/social-media:semantria/add-entities`

| Parameter | Type | Required | Description |
|---|---|---|---|
| config_id | string | no | Identifier of configuration user entities linked to. |
| content_type | string | yes |  |
| body | object | yes | JSON request body |

### Update user entities
`POST https://apizie.tech/v1/social-media:semantria/update-entities`

| Parameter | Type | Required | Description |
|---|---|---|---|
| config_id | string | no | Identifier of configuration user entities linked to. |
| content_type | string | yes |  |
| body | object | yes | JSON request body |

### Remove user entities
`POST https://apizie.tech/v1/social-media:semantria/delete-entities`

| Parameter | Type | Required | Description |
|---|---|---|---|
| content_type | string | yes |  |

### Retrieve supported features
`GET https://apizie.tech/v1/social-media:semantria/get-features`

| Parameter | Type | Required | Description |
|---|---|---|---|
| language | string | no | Filter features by specified language |
| content_type | string | yes |  |

### Retrieve sentiment-bearing phrases
`GET https://apizie.tech/v1/social-media:semantria/get-phrases`

| Parameter | Type | Required | Description |
|---|---|---|---|
| config_id | string | no | Identifier of configuration phrases linked to. |
| content_type | string | yes |  |

### Add sentiment-bearing phrases
`POST https://apizie.tech/v1/social-media:semantria/add-phrases`

| Parameter | Type | Required | Description |
|---|---|---|---|
| config_id | string | no | Identifier of configuration phrases linked to. |
| content_type | string | yes |  |
| body | object | yes | JSON request body |

### Updates sentiment-bearing phrases
`POST https://apizie.tech/v1/social-media:semantria/update-phrases`

| Parameter | Type | Required | Description |
|---|---|---|---|
| config_id | string | no | Identifier of configuration phrases linked to. |
| content_type | string | yes |  |
| body | object | yes | JSON request body |

### Remove sentiment-bearing phrases
`POST https://apizie.tech/v1/social-media:semantria/delete-phrases`

| Parameter | Type | Required | Description |
|---|---|---|---|
| config_id | string | no | Identifier of configuration phrases linked to. |
| content_type | string | yes |  |
| body | object | yes | JSON request body |

### Retrieve queries
`GET https://apizie.tech/v1/social-media:semantria/get-queries`

| Parameter | Type | Required | Description |
|---|---|---|---|
| config_id | string | no | Identifier of configuration queries linked to. |
| content_type | string | yes |  |

### Add or update queries
`POST https://apizie.tech/v1/social-media:semantria/add-queries`

| Parameter | Type | Required | Description |
|---|---|---|---|
| config_id | string | no | Identifier of configuration queries linked to. |
| content_type | string | yes |  |
| body | object | yes | JSON request body |

### Update queries
`POST https://apizie.tech/v1/social-media:semantria/update-queries`

| Parameter | Type | Required | Description |
|---|---|---|---|
| config_id | string | no | Identifier of configuration queries linked to. |
| content_type | string | yes |  |
| body | object | yes | JSON request body |

### Remove queries
`POST https://apizie.tech/v1/social-media:semantria/delete-queries`

| Parameter | Type | Required | Description |
|---|---|---|---|
| config_id | string | no | Identifier of configuration queries linked to. |
| content_type | string | yes |  |
| body | object | yes | JSON request body |

### Retrieve usage statistics
`GET https://apizie.tech/v1/social-media:semantria/get-statistic`

| Parameter | Type | Required | Description |
|---|---|---|---|
| config_id | string | no | Configuration identifier for usage statistics retrieving. |
| interval | string | no | Hour, Day, Week, Month, Year values are supported. |
| content_type | string | yes |  |

### Retrieve API status
`GET https://apizie.tech/v1/social-media:semantria/get-status`

| Parameter | Type | Required | Description |
|---|---|---|---|
| content_type | string | yes |  |

### Retrieve subscription details
`GET https://apizie.tech/v1/social-media:semantria/get-subscription`

| Parameter | Type | Required | Description |
|---|---|---|---|
| content_type | string | yes |  |

### Retrieve taxonomy
`GET https://apizie.tech/v1/social-media:semantria/get-taxonomy`

| Parameter | Type | Required | Description |
|---|---|---|---|
| config_id | string | no | Identifier of configuration taxonomy linked to. |
| content_type | string | yes |  |

### Add taxonomy nodes
`POST https://apizie.tech/v1/social-media:semantria/add-taxonomy`

| Parameter | Type | Required | Description |
|---|---|---|---|
| config_id | string | no | Identifier of configuration queries linked to. |
| content_type | string | yes |  |
| body | object | yes | JSON request body |

### Update taxonomy nodes
`POST https://apizie.tech/v1/social-media:semantria/update-taxonomy`

| Parameter | Type | Required | Description |
|---|---|---|---|
| config_id | string | no | Identifier of configuration queries linked to. |
| content_type | string | yes |  |
| body | object | yes | JSON request body |

### Remove taxonomy nodes
`POST https://apizie.tech/v1/social-media:semantria/delete-taxonomy`

| Parameter | Type | Required | Description |
|---|---|---|---|
| config_id | string | no | Identifier of configuration queries linked to. |
| content_type | string | yes |  |
| body | object | yes | JSON request body |

## Example
```
curl "https://apizie.tech/v1/social-media:semantria/get-blacklist" \
  -H "x-api-key: $APIZIE_KEY"
```

## FAQ

### How do I call the Semantria API?
Create a free Apizie key, then send GET https://apizie.tech/v1/social-media:semantria/get-blacklist with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Semantria API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card.

### Can AI agents use the Semantria 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 social-media:semantria.

### What is the status of the Semantria API?
Live: works with just an Apizie key