Deep Categorization API version 1.0

Do you have any questions? Write us an email or ask us through the feedback section.

Developer tools

Here you have simple examples of requests to the Topics Extraction API. You can use them to test a sample request and get an example response in a quick and easy way, right in your favorite programming language.

import requests

url = "https://api.meaningcloud.com/deepcategorization-1.0"

payload={
    'key': 'YOUR API KEY',
    'txt': 'YOUR TEXT HERE',
    'model': 'MODEL NAME HERE',  # like IAB_2.0_en
}

response = requests.post(url, data=payload)

print('Status code:', response.status_code)
print(response.json())

curl 'https://api.meaningcloud.com/deepcategorization-1.0' \
    -F 'key=YOUR API KEY' \
    -F 'txt=YOUR TEXT HERE' \
    -F 'model=MODEL NAME HERE'

const formdata = new FormData();
formdata.append("key", "YOUR API KEY");
formdata.append("txt", "YOUR TEXT HERE");
formdata.append("model", "MODEL NAME HERE");  // like IAB_2.0_en

const requestOptions = {
  method: 'POST',
  body: formdata,
  redirect: 'follow'
};

const response = fetch("https://api.meaningcloud.com/deepcategorization-1.0", requestOptions)
  .then(response => ({
    status: response.status, 
    body: response.json()
  }))
  .then(({ status, body }) => console.log(status, body))
  .catch(error => console.log('error', error));

<?php

use GuzzleHttp\Client;

$client = new GuzzleHttp\Client();

$response = $client->post('https://api.meaningcloud.com/deepcategorization-1.0', [
    'multipart' => [
        [
            'name'     => 'key',
            'contents' => 'YOUR API KEY'
        ],
        [
            'name'     => 'txt',
            'contents' => 'YOUR TEXT HERE'
        ],
        [
            'name'     => 'model',
            'contents' => 'MODEL NAME HERE'  # like IAB_2.0_en
        ]        
    ]
]);

$status = $response->getStatusCode();
$body = json_decode($response->getBody()->getContents(), true);

SDKs

You can find MeaningCloud's SDK for Python, Java/Scala and PHP in our Github page, and published in public repositories:

PyPi

Packagist

Maven Central

Not enough? You can also check out TailorBrands' Ruby Wrapper and Kiko Beats' Nodejs client. And of course, if you create your own integration in any other language, we'd love to hear about it!