indico API v2 is now live!

April 23, 2015

On April 10th, we made public the indico API v2. It includes some big updates that we’re really excited about:

We’ve beefed up security

  • API V2 uses SSL to encrypt all of your requests
  • API Keys are now required, get your API key here.
  • By filtering out abusive users, we have been able to raise our API limits for users on our free plan.


We’ve updated our Sentiment Model

  • 5x the training data
  • 10% better accuracy
  • We normalized the outputs to be between 0 (least positive) and 1 (most positive).


We’ve vastly improved our documentation

It’s now faster & easier to integrate indico with your applications. Check out our updated docs here.

Also worth mentioning

Fixed Client Libs
In addition to adding batch support, we’ve also squashed quite a few bugs in our client libraries. Hello, Java!
New Political Model
We have a new Political Model that’s more robust and accurate but still short of the gold standard.
Batch Support now available to everyone
Previously only available on paid plans, we have made Batch Support for all APIs available to everyone for high throughput applications.

import indicoio
print(indicoio.text_tags("Blog posts about Android tech make better journalism than  most news outlets."))
    "Iran agress to nuclear limits, but key issues are unresolved.",
    "We're supposed to get up to 24 inches of snow in the storm."


How it will affect you

All new client libraries will use our new API V2. If you still have an old version, you’ll be stuck on our old API. We will be shutting down API V1 on July 1st, please update before then to avoid any interruptions.
To take advantage of the big improvements we recommend you register for an API key and update your client library to the latest version, below is a quick guide on updating your client library in Python.

Updating the Python client library

This is a guide for Python. To upgrade client libraries in other languages, please use the instructions specific to their respective package managers.

For Python:

1) Check the version of indico you currently have installed
The most up to date Python wrapper is version 0.5.2, if your version predates 0.5.2 then you’ll have to update.

pip show indicoio

Check the version of indico you currently have installed
2) Updating to version 0.5.2
The following command will initiate the update process if you’re running on Windows, Ubuntu, or Linux.

pip install indicoio --upgrade

If you’re on Mac OS X, you’ll have to run this command:

sudo pip install indicoio --upgrade

Upgrade command on OS X
3) Check the version after the update to make sure you’re running on version 0.5.2 or higher and you’re good to go.
Double check the version afterwards to version 0.5.2 or higher and you're good to go.
Feel free to reach out if you run into any issues or have any questions! We’re always here to help.