The ilo.so API

The ilo API lets you access some of your Twitter analytics programmatically.

Authentication

Every request requires your ilo API key, which can be found on your Settings page.

To make an authenticated request add the ?api_key=KEY parameter.

Endpoint

There is currently only one endpoint available.

GET https://api.ilo.so/v1/stats/USERNAME/

With this endpoint you can get total and daily stats from your account.

Options

history (default 7): define how many days of data to return.

include_replies (default false): use true to include replies in the tweets_daily data.

Example request

GET https://api.ilo.so/v1/stats/dr/?history=30&api_key=1234567890

This will get 30 days of history for the @dr account (when using the correct API key).

Example response

  {
  "followers": 9521,
  "following": 408,
  "tweets": 8144,
  "followers_total_daily": [
    {
      "2021-02-19": 9376
    },
    {
      "2021-02-20": 9414
    },
    {
      "2021-02-21": 9448
    },
    {
      "2021-02-22": 9460
    },
    {
      "2021-02-23": 9486
    },
    {
      "2021-02-24": 9505
    },
    {
      "2021-02-25": 9521
    }
  ],
  "following_total_daily": [
    {
      "2021-02-19": 404
    },
    {
      "2021-02-20": 405
    },
    {
      "2021-02-21": 405
    },
    {
      "2021-02-22": 404
    },
    {
      "2021-02-23": 406
    },
    {
      "2021-02-24": 407
    },
    {
      "2021-02-25": 408
    }
  ],
  "tweets_total_daily": [
    {
      "2021-02-19": 8085
    },
    {
      "2021-02-20": 8096
    },
    {
      "2021-02-21": 8099
    },
    {
      "2021-02-22": 8110
    },
    {
      "2021-02-23": 8118
    },
    {
      "2021-02-24": 8127
    },
    {
      "2021-02-25": 8144
    }
  ],
  "followers_daily": [
    {
      "2021-02-19": 13
    },
    {
      "2021-02-20": 38
    },
    {
      "2021-02-21": 34
    },
    {
      "2021-02-22": 12
    },
    {
      "2021-02-23": 26
    },
    {
      "2021-02-24": 19
    },
    {
      "2021-02-25": 16
    }
  ],
  "following_daily": [
    {
      "2021-02-19": -4
    },
    {
      "2021-02-20": 1
    },
    {
      "2021-02-21": 0
    },
    {
      "2021-02-22": -1
    },
    {
      "2021-02-23": 2
    },
    {
      "2021-02-24": 1
    },
    {
      "2021-02-25": 1
    }
  ],
  "tweets_daily": [
    {
      "2021-02-19": 13
    },
    {
      "2021-02-20": 11
    },
    {
      "2021-02-21": 3
    },
    {
      "2021-02-22": 11
    },
    {
      "2021-02-23": 8
    },
    {
      "2021-02-24": 9
    },
    {
      "2021-02-25": 17
    }
  ]
}