# Add This

Ruby wrapper for the [Add This Analytics API](http://www.addthis.com/help/analytics-api#.TzzlN0zC4V).

## Installation

```bash
$ gem i add_this
```

## Usage

With your user_id and password define a configure block that defines them like so:

### Global Config

```ruby
AddThis.configure do |config|
  config.user_id = "generalthings"
  config.password = "awesome"
end
```

### or Per Request

```ruby
add_this = AddThis::Client.new(user_id: "generalthings", password: "awesome")
```

For making requests to the api is quite simple it follows most of the current Add 
This Structure for urls only broken by an underscore so [/shares/day](https://api.addthis.com/analytics/1.0/pub/shares/day.csv)
would be a method called `shares_day`


## Example calls

You have two ways available to get data one on the AddThis class like so:

```ruby
AddThis.get.shares_url
```

or by creating the client and requesting through that like so:

```ruby
add_this = AddThis::Client.new
add_this.shares_url
```

or passing query params you just need to provide a hash into that method as so:

```ruby
AddThis.get.shares_url({service: "facebook_like"})
```


Resources:

* [Add This Analytics API](http://www.addthis.com/help/analytics-api#.TzzlN0zC4V)


## Note on Patches/Pull Requests

* Fork the project.
* Make your feature addition or bug fix.
* Add tests for it. This is important so I don't break it in a
  future version unintentionally.
* Commit, do not mess with rakefile, version, or history.
  (if you want to have your own version, that is fine but
   bump version in a commit by itself I can ignore when I pull)
* Send me a pull request. Bonus points for topic branches.

## Copyright

Copyright (c) 2012 General Things Inc. See LICENSE for details.