Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

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

Retrieve Amazon Wishlist and output to JSON, XML, or PHP Array Object
https://github.com/doitlikejustin/amazon-wish-lister

Last synced: about 2 months ago
JSON representation

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

Awesome Lists containing this project

README 

        
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](http://code.google.com/p/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/](http://www.justinscarpetti.com/projects/amazon-wish-lister/)  

**JSON Output:** [http://www.justinscarpetti.com/projects/amazon-wish-lister/api/?id=37XI10RRD17X2](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