LinkShare API

Ruby wrapper for LinkShare Publisher Web Services. Supported web services:

• Automated LinkGenerator
• Merchandiser Query Tool

If you need services that are not yet supported, feel free to contribute. For questions or bugs please create an issue.

Installation

Add this line to your application's Gemfile:

gem 'linkshare_api'

And then execute:

$ bundle

Or install it yourself as:

$ gem install linkshare_api

Requirements

Ruby 1.9 or above.

Usage

Before using LinkShare API you need to set up your publisher token first. If you use Ruby on Rails, the token can be set in a configuration file (i.e. app/config/initializers/linkshare_api.rb), otherwise just set it in your script. The token can be found on LinkShare's Web Services page under the Links tab.

require "linkshare_api" # no need for RoR
LinkshareAPI.token = ENV["LINKSHARE_TOKEN"]

Automated Link Generator

Generate affiliate URLs using Automated LinkGenerator service. Below is an example of generating an affiliate URL for Walmart. Walmart merchant code is 2149.

url = "http://www.walmart.com/cp/Electronics/3944?povid=P1171-C1093.2766-L33"
affiliate_url = LinkshareAPI.link_generator(2149, url)

Merchandiser Query Tool

Search for products using Merchandiser Query Tool service.

response = LinkshareAPI.product_search(keyword: "laptop")
# Return the number of total records that match the search criteria
puts response.total_matches # -1 means more than 4000 results (see doc)
# Return the number of pages
puts response.total_pages
# Return the number of current page
puts response.page_number
# See the actual API call to Linkshare
puts response.request.uri
# Return items
response.data.each do |item|
  puts "Title: #{item.productname}"
  puts "Price: #{item.price.__content__} #{item.price.currency}"
  puts "URL: #{item.linkurl}"
end

product_search accepts a hash as argument, and can include all available options. For a complete list of options please visit http://helpcenter.linkshare.com/publisher/questions.php?questionid=652.

# Search "laptop" only for Wal-Mart, within Electronics category,
# sorted by price ascending, and limit to 10 items per page.
options = {
  keyword: "laptop",
  mid: 2149, # Wal-Mart
  cat: "Electronics",
  max: 10,
  sort: :retailprice,
  sorttype: :asc
}
response = LinkshareAPI.product_search(options)
response.data.each do |item|
  # Do stuff
end

If there are multiple pages, you can retrieve all pages by using the all method, as follows:

response.all.each do |item|
  # Do stuff
end

When using the all method, response object is updated with the data returned by the last API request (last page). response.all returns the data array.

Coupon Web Services

Easy access to coupons and promotional link data for your advertisers using Coupon Web Service

# Search for promotion types "Clearance" (id 3) and "Dollar Amount Off" (id 5)
# from Wal-Mart (id 2149) within category "Apparel - Babies & Kids" (id 3)
# in the US network (id 1)
options = {
  promotiontype: 3|5,
  mid: 2149,
  cat: 3,
  network: 1
}
response = LinkshareAPI.coupon_web_service(options)
response.data.each do |item|
  # Do stuff
end

Extra Configuration

• LinkshareAPI.api_timeout - the timeout set when initiating requests to LinkShare Web Services (default value is 30 seconds)

Contributing

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request

License

MIT