PHPackages                             doitlikejustin/amazon-wish-lister - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. doitlikejustin/amazon-wish-lister

ActiveLibrary

doitlikejustin/amazon-wish-lister
=================================

Retrieve Amazon Wishlist and output to JSON, XML, or PHP Array Object http://www.justinscarpetti.com/portfolio/amazon-wish-lister/

4011684[10 issues](https://github.com/doitlikejustin/amazon-wish-lister/issues)[2 PRs](https://github.com/doitlikejustin/amazon-wish-lister/pulls)PHP

Since Oct 11Pushed 7y ago34 watchersCompare

[ Source](https://github.com/doitlikejustin/amazon-wish-lister)[ Packagist](https://packagist.org/packages/doitlikejustin/amazon-wish-lister)[ RSS](/packages/doitlikejustin-amazon-wish-lister/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (5)DependenciesVersions (1)Used By (0)

Amazon Wish Lister
==================

[](#amazon-wish-lister)

**GitHub Page: **

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:**
**JSON Output:**

How to use
==========

[](#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

[](#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

[](#amazon-id)

`?id=YOUR_AMAZON_ID`
`?id=37XI10RRD17X2`

### Reveal (What to get)

[](#reveal-what-to-get)

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

### Sort

[](#sort)

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

### Output Format

[](#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
--------------------------------

[](#amazon-associate--affiliate-tag)

`?tag=affiliate-tag`

### Example

[](#example)

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

What it returns
===============

[](#what-it-returns)

Below is an example if you had  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
=======

[](#support)

###  Health Score

29

—

LowBetter than 60% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity28

Limited adoption so far

Community22

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 69.8% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/b3beff1b9bd92b2b557a28a7f06068686f3da052ed1afbc8ca91480b60aa337a?d=identicon)[doitlikejustin](/maintainers/doitlikejustin)

---

Top Contributors

[![doitlikejustin](https://avatars.githubusercontent.com/u/637056?v=4)](https://github.com/doitlikejustin "doitlikejustin (30 commits)")[![edent](https://avatars.githubusercontent.com/u/837136?v=4)](https://github.com/edent "edent (8 commits)")[![ethanclevenger91](https://avatars.githubusercontent.com/u/2623646?v=4)](https://github.com/ethanclevenger91 "ethanclevenger91 (5 commits)")

### Embed Badge

![Health badge](/badges/doitlikejustin-amazon-wish-lister/health.svg)

```
[![Health](https://phpackages.com/badges/doitlikejustin-amazon-wish-lister/health.svg)](https://phpackages.com/packages/doitlikejustin-amazon-wish-lister)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
