MonkeyLearn

The MonkeyLearn modules allow you to create, update, and delete the classifiers, and extractors in your MonkeyLearn account.

Getting Started with MonkeyLearn

Prerequisites

  • A MonkeyLearn account

In order to use MonkeyLearn with Make, it is necessary to have a MonkeyLearn account. If you do not have one, you can create a MonkeyLearn account at app.monkeylearn.com/accounts/register.

Notice

The module dialog fields that are displayed in bold (in the Make scenario, not in this documentation article) are mandatory!

Connecting MonkeyLearn to Make

To connect your MonkeyLearn account to Make you need to obtain the API Key from your MonkeyLearn account and insert it in the Create a connection dialog in the Make module.

1. Log in to your MonkeyLearn account.

2. Open the model you want to create or use and then click API. Copy the API Key to your clipboard.

abngldfd2n.gif

3. Go to Make and open the MonkeyLearn module's Create a connection dialog.

61d6a9d48de04.gif

4. In the Connection name field, enter the name of the connection.

5. In the API Key field, enter the API key copied in step 2 and click Continue.

The connection has been established.

Classifiers

Returns all the available classifiers for the user.

Connection

Establish a connection to your MonkeyLearn account.

Order by

Enter the order in which you want to list the classifiers.

For example, -created, ascending, or -updated, descending.

You can specify the order of the list. It can be ordered using any of the field names, either in ascending or descending order (adding ‘-’ before the name). Also, more than one criteria can be specified, separated by commas.

Limit

Enter the maximum number of classifiers Make must return during one scenario execution cycle.

Returns information about a classifier including its settings, stats, and tags.

Connection

Establish a connection to your MonkeyLearn account.

Model ID

Select the Model ID whose details you want to retrieve.

Classifies the text with a given classifier.

Connection

Establish a connection to your MonkeyLearn account.

Model ID

Select the Model ID whose text you want to classify.

Text

Enter the text you want to classify.

External ID

Enter any External ID which you want to include in the response.

Production Model

Select whether you want to perform the classification by the production model:

  • Yes

  • No

  • Not defined

Uploads data to a classifier.

Connection

Establish a connection to your MonkeyLearn account.

Model ID

Select the Model ID whose classifier data you want to upload.

Data

Add the data objects:

Text

Enter the text to add or update.

Tags

Enter the list of keywords for referring to the text by their Numeric ID and their name.

Markers

Add the list of markers associated with the text.

Input Duplicate Strategy

Select the action to perform for duplicate texts in the request:

  • Merge

  • Keep First

  • Keep Last

Existing Duplicate Strategy

Select the action to perform for existing texts in the model:

  • Ignore

  • Overwrite

  • Merge

Creates a new classifier.

Connection

Establish a connection to your MonkeyLearn account.

Name

Enter a name for the classifier model.

Description

Enter the details of the classifier model.

Algorithm

Select the algorithm in which the model is trained:

  • NB

  • SVM

Language

Select the language of the model.

Max Features

Enter the maximum number of features used when training the model.

The value must be greater than or equal to 10 and less than or equal to 10000.

Ngram Range

Enter a two-digit n-gram range used when training the model. For example, [2, 3].

The numbers must be between 1 and 3 and they indicate the minimum and maximum n for the n-grams used respectively.

Use Stemming

Select whether the stemming is used when training the model:

  • Yes

  • No

  • Not defined

Preprocess Numbers

Select whether the number preprocessing is done when training the model:

  • Yes

  • No

  • Not defined

Preprocess Names

Select whether the people names preprocessing is used when training the model:

  • Yes

  • No

  • Not defined

Preprocess Emails

Select whether the email addresses preprocessing is used when training the model:

  • Yes

  • No

  • Not defined

Preprocess URLs

Select whether the URLs preprocessing is used when training the model:

  • Yes

  • No

  • Not defined

Preprocess Social Media

Select whether the preprocessing of social media is done when training the model:

  • Yes

  • No

  • Not defined

Normalize Weights

Select whether the weights will be normalized when training the model:

  • Yes

  • No

  • Not defined

Stopwords

Enter the comma-separated list of the stopwords used when training the module.

Whitelist

Enter the comma-separated list of the whitelists of words used when training the module.

Tagging Strategy

Select the tagging strategy of the model:

  • Autodetect

  • Single

  • Multi

Updates a classifier name, description, and settings.

Connection

Establish a connection to your MonkeyLearn account.

Model ID

Select the Model ID you want to update.

Name

Enter a name for the classifier model.

Description

Enter the details of the classifier model.

Algorithm

Select the algorithm in which the model is trained:

  • NB

  • SVM

Language

Select the language of the model.

Max Features

Enter the maximum number of features used when training the model.

The value must be greater than or equal to 10 and less than or equal to 10000.

Ngram Range

Enter a two-digit n-gram range used when training the model. For example, [2, 3].

The numbers must be between 1 and 3 and they indicate the minimum and maximum n for the n-grams used respectively.

Use Stemming

Select whether the stemming is used when training the model:

  • Yes

  • No

  • Not defined

Preprocess Numbers

Select whether the number preprocessing is done when training the model:

  • Yes

  • No

  • Not defined

Preprocess Names

Select whether the people names preprocessing is used when training the model:

  • Yes

  • No

  • Not defined

Preprocess Emails

Select whether the email addresses preprocessing is used when training the model:

  • Yes

  • No

  • Not defined

Preprocess URLs

Select whether the URLs preprocessing is used when training the model:

  • Yes

  • No

  • Not defined

Preprocess Social Media

Select whether the preprocessing of social media is done when training the model:

  • Yes

  • No

  • Not defined

Normalize Weights

Select whether the weights will be normalized when training the model:

  • Yes

  • No

  • Not defined

Stopwords

Enter the comma-separated list of the stopwords used when training the module.

Whitelist

Enter the comma-separated list of the whitelists of words used when training the module.

Tagging Strategy

Select the tagging strategy of the model:

  • Autodetect

  • Single

  • Multi

Deletes a classifier.

Connection

Establish a connection to your MonkeyLearn account.

Model ID

Select the Model ID you want to delete.

Extractors

Returns all the available extractors for the user.

Connection

Establish a connection to your MonkeyLearn account.

Order by

Enter the order in which you want to list the extractors.

For example, -created, ascending, or -updated, descending.

You can specify the order of the list. It can be ordered using any of the field names, either in ascending or descending order (adding ‘-’ before the name). Also, more than one criteria can be specified, separated by commas.

Limit

Enter the maximum number of extractors Make must return during one scenario execution cycle.

Returns information about an extractor.

Connection

Establish a connection to your MonkeyLearn account.

Model ID

Select the Model ID whose details you want to retrieve.

Extracts information from the text with a given extractor.

Connection

Establish a connection to your MonkeyLearn account.

Model ID

Enter the maximum number of classifiers Make must return during one scenario execution cycle.

Text

Enter the text you want to extract.

External ID

Enter the External ID which you want to give in the request for the text to include in the response.

Production Model

Select whether you want to perform the classification by the production model:

  • Yes

  • No

  • Not defined

Other

Performs an arbitrary authorized API call.

Connection

Establish a connection to your MonkeyLearn account.

URL

Enter a path relative to https://api.monkeylearn.com/. For example: /v3/classifiers

Note

For the list of available endpoints, refer to the MonkeyLearn API Documentation.

Method

Select the HTTP method you want to use:

GET to retrieve information for an entry.

POST to create a new entry.

PUT to update/replace an existing entry.

PATCH to make a partial entry update.

DELETE to delete an entry.

Headers

Enter the desired request headers. You don't have to add authorization headers; we already did that for you.

Query String

Enter the request query string.

Body

Enter the body content for your API call.

The following API call returns all the classifiers from your MonkeyLearn account:

URL: /v3/classifiers

Method: GET

61d6a9d7235fd.png

Matches of the search can be found in the module's Output under Bundle > Body. In our example, 20 classifiers were returned:

61d6a9d85b093.png