Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jaymon/wishlist
Read an Amazon wishlist programmatically with Python
https://github.com/jaymon/wishlist
amazon amazon-wishlist api crawler python scraper
Last synced: 9 days ago
JSON representation
Read an Amazon wishlist programmatically with Python
- Host: GitHub
- URL: https://github.com/jaymon/wishlist
- Owner: Jaymon
- License: other
- Created: 2016-09-02T07:37:20.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2023-05-18T20:55:39.000Z (over 1 year ago)
- Last Synced: 2024-09-23T02:47:58.370Z (about 1 month ago)
- Topics: amazon, amazon-wishlist, api, crawler, python, scraper
- Language: Python
- Homepage:
- Size: 354 KB
- Stars: 52
- Watchers: 4
- Forks: 11
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Wishlist
Python library to grab your Amazon wishlist so you can mess with it programmatically.
## Dependencies
### What do I need if I have a private wishlist?
Wishlist depends on [Brow](https://github.com/Jaymon/brow) in order to login from the command line (including 2 factor if enabled), and Brow depends on Selenium and Firefox to be installed, so you'll need to read [Brow's README](https://github.com/Jaymon/brow/blob/master/README.md) if you need help installing those on Linux.
### What do I need if I have a public wishlist?
Nothing special, `pip install wishlist` should cover you, jump down to "Commandline wishlist access" and get started.
## 1 minute getting started
### Authentication for private lists
Is your wishlist private? Then you will need to authenticate on the command line:
$ wishlist auth
This will prompt you to signin and will even handle 2-factor authentication, after you signin your cookies will be saved so you can access your Amazon wishlist on the command line.
### Commandline wishlist access
You can check access to your wishlist on the command line by running:
$ wishlist dump NAME
where `NAME` is the part of a url like `https://www.amazon.com/gp/registry/wishlist/NAME`, so, if your wishlist was found at: `https://www.amazon.com/gp/registry/wishlist/9YDNFG31NSSRL` then you would run:
$ wishlist dump 9YDNFG31NSSRL
### Programmatic wishlist access
If you wanted to do something in another python script, you can do:
```python
from wishlist.core import Wishlist
name = "9YDNFG31NSSRL"
w = Wishlist(name)
for item in w:
print(item.jsonable())
```
You can check the [wishlist.core.WishlistElement](https://github.com/Jaymon/wishlist/blob/master/wishlist/core.py) code to understand the structure of each wishlist item.
## Installation
use pip:
$ pip install wishlist
To get the bleeding edge version:
$ pip install --upgrade "git+https://github.com/Jaymon/wishlist#egg=wishlist"
## Regions
To change Amazon region from the default (amazon.com) to another (e.g. amazon.co.uk) just set the environment variable WISHLIST_HOST, for example:
```
export WISHLIST_HOST=https://amazon.co.uk
```
The environment is setup at module import, so if you need to modify the environment during runtime you should use `wishlist.environ`, so to set the host at runtime, you could do something like:
```python
from wishlist.core import Wishlist
from wishlist import environ
environ.HOST="https://www.amazon.fr"
```
## Other things
* Why are you using Firefox for logging in? Why not Chrome? I tried to get it to work in headless Chrome but all the features I needed to work out authentication on the command line weren't supported.
* Would you rather use php? [There's a library for that](https://github.com/doitlikejustin/amazon-wish-lister) ([also related](https://shkspr.mobi/blog/2015/11/an-api-for-amazon-wishlists/)).
* [Amazon's advertising api](http://docs.aws.amazon.com/AWSECommerceService/latest/DG/Welcome.html) is where the officially supported wishlist api used to live.