Overview

Repustate's API is a simple RESTful API. All responses are in JSON format. Pay special attention to which HTTP verb is required. Successful responses return an HTTP status code of 200. Incorrect or missing arguments will result in status code 400.

Endpoint

Rate Limiting

There are no limits to the number of calls you can make per minute/hour/day etc. however all accounts are subject to monthly limits according to the plan you signed up for. In the event that you exceed your monthly quota, you will receive an HTTP 429 response on all subsequent API calls.

Client Libraries

Multiple languages

Most API calls can be used with multiple languages, not just in English. To specify another language, you have to provide the two letter code for the language you're interested in. The languages currently supported are:

Language

Code

Arabic (العربية)

ar

Chinese (中文)

zh

Dutch (Nederlands)

nl

English

en

French (Français)

fr

German (Deutsch)

de

Hebrew (עִברִית)

he

Italian (Italiano)

it

Japanese (日本語)

ja

Korean (한국어)

ko

Polish (Polski)

pl

Portuguese (Português)

pt

Russian (русский)

ru

Spanish (Español)

es

Turkish (Türk)

tr

Thai (ไทย)

th

Vietnamese (Tiếng Việt)

vi

Authentication

There is no explicit authentication mechanism. You simply include your API key in each API request.

Multiple Accounts

Sometimes it's necessary to maintain multiple profiles of sentiment
rules, especially if you are an agency or a social media analytics
company. You don't want to mix up one set of rules/scores with
another. To that end, Repustate supports a means to keep your
custom rules and subsequent sentiment analysis separate by use of a
custom HTTP header "X-Sub-Account". This way, you still only need
one Repustate API key, but can create rules for multiple "sub
accounts" that you create and maintain on your end. Here's an
example use of this header using cURL: