Affiliate Program

Topic covered:

Using a Commission Junction Affiliate ID with Best Buy's product
catalog API

Remix has the ability to provide links to products on BestBuy.com
that include your CJ Publisher ID, or PID, ensuring that you get
affiliate credit for purchases resulting from the referral. This
capability is activated automatically when a request to the Remix API
includes the "PID=" parameter.

Two links are available. Using the link in the <cjAffiliateUrl>
attribute will bring the customer to a product's detail page. Using the
link in the <cjAffiliateAddToCartUrl> parameter will add the item to the
customer's BestBuy.com cart and bring the customer to the cart page.

To use Remix, you will need a Remix API Key. To obtain one, visit
http://remix.bestbuy.com. You'll need to sign up for an account and
request a key. If you encounter any problems with this process, please
contact remix@bestbuy.com or post in the Remix forums.

Once you have your API key, you'll make an API call, providing
information about who you are (your API key and your PID) and letting
Remix know what you want to know.

For example, if you want a list of all Nikon products that cost more
than $200, you'd call this URL:

http://api.remix.bestbuy.com/v1/products(manufacturer=nikon&salePrice>20
0)?show=all&sort=salePrice&apiKey=<YourApiKey>&PID=<yourPID>

Back to Top

Let's decode that URL.

http://api.remix.bestbuy.com/
This is the base Remix URL.

v1/
This is the version of the API which you are querying.  Using this, you
can have a stable base to build on, even as the API evolves. v1 is the
current version of the API.

products
This is the query type, and indicates what sort of information you're
requesting.  Remix supports 2 types: stores and products.  You can also
join the two to view information about store availability.

(manufacturer=nikon&salePrice>200)
This is a filter applied to your request.  In this case, the above query
will only return products that are manufactured by nikon and have a sale
price (also known as current price) greater than $200.

?show=all
This displays all data points available for any product returned for the
query. You can limit which attributes are displayed by specifying them
here (ie. show=name, sku, manufacturer, salePrice). Note: Using the
'show=all' parameter initially will return all the other parameters that
are available to refine your query (ie. Search by 'manufacturer' and/or
sort by 'salePrice').

&sort=salePrice
There are a number of additional parameters which you may specify in
your query which will further adjust the results, for example, sorting
them, or limiting which attributes are displayed. More information about
this is available at the Remix portal site, http://remix.bestbuy.com.

&apiKey=<YourApiKey>
Your API Key grants you access to the Remix service.  You'll need to
include it with every request.

&PID=<yourPID>
You need to include your CJ Publisher ID to get links that will allow
you to get credit for sales resulting from your referral, following the
rules of the affiliate program.

The above call returns 4 pages of results totaling 33 items.

Back to Top

Example API Call - single product
Say you want to create a link to Batman Begins, Best Buy SKU 8880044,
that will get you affiliate credit. You'd pass in this query to Remix:

http://api.remix.bestbuy.com/v1/products/8880044.xml?PID=<yourPID>&show=
name,cjAffiliateUrl&apiKey=<yourAPIKey>

This would get back this response:

<product>
<name>Batman Begins - Blu-ray Disc</name>
<cjAffiliateUrl>
http://www.jdoqocy.com/click-99999-10638425?url=http%3A%2F%2Fwww.bestbuy
.com%2Fsite%2Folspage.jsp%3FskuId%3D8880044%26type%3Dproduct%26id%3D1484
301%26ci_src%3D11138%26ci_sku%3D8880044%26nAID%3D11138%26ref%3D39%26loc%
3D01%26cmp%3DRMX%26ky%3Dnnczyvb7z4uvsxrp8q2sxf9a&cjsku=8880044
</cjAffiliateUrl>
</product>

If you want more information, you can either specify the attributes you
want or use show=all to get all information.

Example API Call - product category
If you want to get a list of all products in a given category, you would
use the <categoryPath.name> attribute, like so:

http://api.remix.bestbuy.com/v1/products(categoryPath.name=Laptops)?show
=all&apiKey=<yourAPIKey>

The values of categoryPath.name are taken from BestBuy.com categories.

Back to Top