/amazon-wish-lister

Retrieve Amazon Wishlist and output to JSON, XML, or PHP Array Object

Primary LanguagePHPMIT LicenseMIT

Amazon Wish Lister

GitHub Page: http://doitlikejustin.github.io/amazon-wish-lister/

This is a little API to retrieve Amazon Wish List data. There is no official API, as Amazon shut it down a couple years ago. The only way around that... screen scraping. It works with both old and new (beta) Amazon Wish List design.

The following Amazon stores have wishlist functionality - Canada, USA, Brasil, Japan, UK, Germany, France, India, Italy, Spain.

Amazon Wish Lister uses phpQuery (server-side CSS3 selector driven DOM API based on jQuery) to scrape Amazon's Wish List page and exports to JSON, XML, or PHP Array Object.

  • Scrapes the following from your Amazon Wish List:
    1. Item name
    2. Item link
    3. Price of item when added to wish list
    4. Current price of item
    5. Date added to wish list
    6. Priority (set by you)
    7. Item rating
    8. Total ratings
    9. Comments on item (set by you)
    10. Picture of item
  • Perfect if you want to host display your wish list on your own website.
  • Best used if cached, or saved in database.
  • Supports multi-page Amazon Wish Lists as well as Amazon Wish List "Ideas"
  • Return list as JSON, XML, or just dump PHP Array Object.

Demo Site: http://www.justinscarpetti.com/projects/amazon-wish-lister/
JSON Output: http://www.justinscarpetti.com/projects/amazon-wish-lister/api/?id=37XI10RRD17X2

How to use

You just need to add a few parameters to get your wish list. All of the parameters, except for the Amazon ID, will have a default... well the default for the Amazon ID is my Amazon ID, you probably don't want that.

The rest (how you style it) is up to you. Happy coding.

Amazon Country

?tld=AMAZON_COUNTRY
?tld=co.uk

Defaults to com.

Tested with: ca, com, com.br, co.jp, co.uk, es, de, fr, in, it.

The following stores currently do not offer wishlists: com.au, com.mx, nl.

Amazon ID

?id=YOUR_AMAZON_ID
?id=37XI10RRD17X2

Reveal (What to get)

?reveal=unpurchased (Default)
?reveal=all
?reveal=purchased

Sort

?sort=date (Default)
?sort=priority
?sort=title
?sort=price-low (low to high)
?sort=price-high (high to low)
?sort=updated

Output Format

?format=json Valid JSON (Default).
?format=xml Invalid XML (included for compatibility reasons).
?format=XML Valid XML.
?format=array a PHP array.
?format=rss an RSS feed. You may wish to customise the fields it returns.

Amazon Associate / Affiliate tag

?tag=affiliate-tag

Example

wishlist.php?id=37XI10RRD17X2&reveal=all&sort=priority&format=json
wishlist.php?tld=co.uk&id=13GFCFR2B2IX4&tag=shkspr-21

What it returns

Below is an example if you had http://amzn.com/B0002FTH66 on your wishlist (item #37 on your wishlist).

[
    {
        "num": 37,
        "name": "Scotch Box Sealing Tape Dispenser H180, 2 in",
        "link": "http://www.amazon.com/Scotch-Sealing-Tape-Dispenser-H180/dp/B0002FTH66/ref=wl_it_dp_v_nS_nC/185-8110132-3235609?ie=UTF8&colid=3DR0P4HP87IIJ&coliid=I19JS64ZHWBA5M",
        "old-price": "$24.09",
        "new-price": "$19.99",
        "date-added": "June 7, 2012",
        "priority": "low",
        "rating": "4.7 out of 5 stars",
        "total-ratings": "63",
        "comment": "I like taping stuff",
        "picture": "http://ecx.images-amazon.com/images/I/41BKbZu836L._SL500_SL135_.jpg",
        "page": 2,
        "AISN": "B0002FTH66",
        "large-ssl-image": "https://images-eu.ssl-images-amazon.com/images/I/41BKbZu836L._SL500_SL1350_.jpg",
        "affiliate-url": "http://www.amazon.com/dp/B0002FTH66/ref=nosim?tag=yourid-21"
    }
]

Support

https://github.com/doitlikejustin/amazon-wish-lister/issues