Count.io

Count.io is a simple, persistent, counting API used to count arbitrary stuff.

Counting is a simple programming challenge. However, keeping your count persistent can be a pain.

For this, we created count.io. Simply create a public URL, call it, and we'll keep your count for you.

Use it to:

  • Count events in your application or website
  • Count user conversions
  • Create your own like button

It's incredibly simple. The API follows a pattern like this:

http://count.io/vb/$group/$id[+/-]

See how to start counting "apples" below.

To count "apples" simply make a POST request like this:

http://count.io/vb/fruit/apples+

Notice the + sign on the end of the URL.

Returns this JSON:

{
   "item":"apples",
   "count":1,
   "group":"fruit"
}

Use the "group" field to tie similar themed counts together. In this case it's "fruit."

If you call the URL again, you'll notice the count is incremented by 1.

{
   "item":"apples",
   "count":2,
   "group":"fruit"
}

To increment by more than one, include an "IncrementBy" variable in your POST request. The IncrementBy value will increase the count by its absolute value.

Try a few commands here on Apigee's web console.

You can subtract one "apple" from your count using this POST request:

http://count.io/vb/fruit/apples-

Notice the - sign on the end of the URL.

To decrement by more than one, include a "DecrementBy" variable in your POST request. The DecrementBy value will decrease the count by its absolute value.

Try a few commands here on Apigee's web console.

To retrieve the count without incrementing or decrementing, make a GET request and do not include a + or - sign on the end of the URL, like this:

http://count.io/vb/fruit/apples/

You can even get a sum of all you the items in your "group" like this:

http://count.io/vb/fruit/

Returns this JSON::

{
   "group":"fruit",
   "sum":7,
   "counts":[
      {
         "item":"apples",
         "count":2
      },
      {
         "item":"oranges",
         "count":1
      },
      {
         "item":"bananas",
         "count":4
      }
   ]
}
  • All URLs are public. We recommend using a unique group name, such as a GUID, to avoid collisions with other users.
  • The "vb" in the URL represents the version of the API. "vb" is "version beta."
  • If a URL is not updated or read after 48 hours, it's data may be deleted.
  • The beta is a proof of concept. Private URLs, infinitely persistent data, and more on the road-map if we receive traction.

Pro accounts get:

  • Private URLs secured with basic authentication.
  • Your counts last forever, and are NOT removed due to inactivity.
  • Where the public API requires POST requests, you can make optional GET requests.
  • Access to charts and graphs of your counts.

Early adopters get the PRO account at a locked-in rate of $10/month.

Sign-up Now!