Not Logged In

Zinc 0.1.17

Welcome to Zinc

Zinc is an API for making e-commerce purchases. This package allows you to easily access the API and make purchases on Amazon through the command line. It also offers wrappers around the Zinc API that can be used easily in python code.

The module features:

Interactive wizard for purchasing Amazon items from the command line

Simple order script that reads your order information from a json file and places the order

Python module that allows you to write your own scripts on top of the Zinc API

Quick Start

For starting quickly, you can either clone the repo or use the pip python package manager.:

pip install zinc

(You might need to use sudo pip install zinc if you get an error). Once you’ve installed the Zinc module, you can start using it like so:

python -m zinc

This will bring up an interactive wizard interface that you can use the make Amazon purchases. Follow the instructions in the wizard, and you’ll be able to make a purchase directly from your terminal!

CLI Options

There are other ways of using the Zinc CLI. You can create a json file which will store your shipping and billing information. You can run python -m zinc -h to get help for the commands that you can use. For example, I might have the file ~/.zincrc with the following contents:

Then I could run the cli with the -f option pointing to this shipping address file so that I wouldn’t have to enter my shipping address again in the interactive wizard:

python -m zinc -f ~/.zincrc

You can include credit card information if you’d like (we have an example in the examples/sample_information.json for reference), but we highly discourage you from including it. It’s a BAD idea to leave your credit card information on your hard drive in plaintext.

The examples folder has an example file that has fake prepopulated information that you can try. You won’t be able to complete a full purchase with it, though, because it’s a fake credit card number. To run the wizard with the fake information, you can do:

python -m zinc -f examples/sample_information.json

Simple Order

If you don’t like going through the process of making orders through the interactive cli, you can also use the Zinc simple order module. This is a python module which allows you to make orders by pre-specifying all of your required fields in a python dictionary or a json file.

You can see an example of the simple order format in examples/simple_order.json, reproduced below:

Once you’ve written this down into a json file, you can specify the -s option (for simple order) and you can run:

python -m zinc -s -f examples/simple_order.json

To make simple orders, you just need to prepopulate all the relevant information like shipping address, billing address, payment method information, etc. The product_id field corresponds to the Amazon Standard Identification Number (ASIN), which can be found in the Amazon product url. You will aslo need to set the shipping_preference field, explained in the next section.

Shipping Methods

For the shipping_preference item, you can set different preferences for how you want your items shipped. The available preferences are:

cheapest: Select the cheapest shipping method available

second: Select second day shipping

standard: Select the standard shipping method

Python Usage

Instead of using the CLI, you can also import the zinc module into one of your python scripts. This allows you to customize and automate your Amazon purchases. You can use the ZincSimpleOrder class to easily access the Zinc API. You can check out the examples/simple_order_example.py script to see how to use it (reproduced below):

You can check out an example python script that processes orders from a python file concurrently. The script is in examples/multi_process.py.

Advanced Python Usage

If you’d like to get more control over your API, you can use the ZincRequestProcessor class to make requests. The process method for the ZincRequestProcessor class allows you to place any call to the Zinc API and wait for the response. For example, you could do something like the following: