API Documentation

Sentimental Analysis API Documentation

Classify the sentiment of any given text.

POST https://api.iapp.co.th/sentimental-analysis/predict

Predict the sentiment of any given text in Thai language

Query Parameters

Name	Type	Description
text*	String	Input Text in Thai lanaguage

Headers

Name	Type	Description
apikey*	String	API Key

200: OK Positive Example

https://api.iapp.co.th/sentimental-analysis/predict?text=โครตดีงาม

{
    "label": "pos",
    "score": 0.9159907102584839
}

200: OK Neutral Example

https://api.iapp.co.th/sentimental-analysis/predict?text=เฉยๆ

{
    "label": "neu",
    "score": 0.8166645169258118
}

200: OK Negative Example

https://api.iapp.co.th/sentimental-analysis/predict?text=ไร้คุณภาพ

{
    "label": "neg",
    "score": 0.9052726626396179
}

422: Unprocessable Entity Empty Input Text

{
    "detail": [
        {
            "loc": [
                "query",
                "text"
            ],
            "msg": "ensure this value has at least 1 characters",
            "type": "value_error.any_str.min_length",
            "ctx": {
                "limit_value": 1
            }
        }
    ]
}

Sample Request

cURL

curl --location --request POST 'https://api.iapp.co.th/sentimental-analysis/predict?text=' \
--header 'apikey: {YOUR API KEY}'

Java-Unitest

Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://api.iapp.co.th/sentimental-analysis/predict?text=")
  .header("apikey", "{YOUR API KEY}")
  .asString();

NodeJs-Request

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://api.iapp.co.th/sentimental-analysis/predict?text=',
  'headers': {
    'apikey': '{YOUR API KEY}'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

Objective C

#import <Foundation/Foundation.h>

dispatch_semaphore_t sema = dispatch_semaphore_create(0);

NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:@"https://api.iapp.co.th/sentimental-analysis/predict?text="]
  cachePolicy:NSURLRequestUseProtocolCachePolicy
  timeoutInterval:10.0];
NSDictionary *headers = @{
  @"apikey": @"{YOUR API KEY}"
};

[request setAllHTTPHeaderFields:headers];

[request setHTTPMethod:@"POST"];

NSURLSession *session = [NSURLSession sharedSession];
NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request
completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
  if (error) {
    NSLog(@"%@", error);
    dispatch_semaphore_signal(sema);
  } else {
    NSHTTPURLResponse *httpResponse = (NSHTTPURLResponse *) response;
    NSError *parseError = nil;
    NSDictionary *responseDictionary = [NSJSONSerialization JSONObjectWithData:data options:0 error:&parseError];
    NSLog(@"%@",responseDictionary);
    dispatch_semaphore_signal(sema);
  }
}];
[dataTask resume];
dispatch_semaphore_wait(sema, DISPATCH_TIME_FOREVER);

PHP - Request2

<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://api.iapp.co.th/sentimental-analysis/predict?text=');
$request->setMethod(HTTP_Request2::METHOD_POST);
$request->setConfig(array(
  'follow_redirects' => TRUE
));
$request->setHeader(array(
  'apikey' => '{YOUR API KEY}'
));
try {
  $response = $request->send();
  if ($response->getStatus() == 200) {
    echo $response->getBody();
  }
  else {
    echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
    $response->getReasonPhrase();
  }
}
catch(HTTP_Request2_Exception $e) {
  echo 'Error: ' . $e->getMessage();
}

Python

import requests

url = "https://api.iapp.co.th/sentimental-analysis/predict?text="

payload={}
headers = {
  'apikey': '{YOUR API KEY}'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

Sample Response

Positive

https://api.iapp.co.th/sentimental-analysis/predict?text=โครตดีงาม

{
    "label": "pos",
    "score": 0.9159907102584839
}

Neutral

https://api.iapp.co.th/sentimental-analysis/predict?text=เฉยๆ

{
    "label": "neu",
    "score": 0.8166645169258118
}

Negative

https://api.iapp.co.th/sentimental-analysis/predict?text=ไร้คุณภาพ

{
    "label": "neg",
    "score": 0.9052726626396179
}

Postman Request Example

https://api.postman.com/collections/5145656-2bdbb882-68a3-4877-b498-da6bd5962e00?access_key=PMAT-01GS9DVBDFTYR6D8G2CFW7ZC6Wapi.postman.com