Skip to main content

Easily use Outpan API to get product info from its barcode

Project description

PyPI latest version badgeCode health

Python client for the API


You’ll first need to create an account and get your API key.

Once you have your API key and the package is installed - see below - you are set and ready to go.

Getting ready

To access the Outpan API you’ll need to create an instance of OutpanApi with your API key. You’ll use this object to access the API.

from outpan import OutpanApi
api = OutpanApi(my_api_key)

Getting a product’s data

Now that you are set it is time to make calls to the API. The first thing you will want to do is retrieve a product information. For our test we’ll use the test barcode 078915030900.


This call will return the product’s data as a dict:

{'attributes': {'Care': 'Dishwasher safe',
                'Colors': 'White',
                'Manufacturer': 'Progressive International',
                'Material': 'Plastic, Stainless Steel',
                'Part Number': 'GPC-5000'},
 'gtin': '0078915030900',
 'images': ['',
 'name': 'Progressive International Cherry-It Pitter',
 'videos': ['',

The v1 API allows you to retrieve specific attributes of a product using the following methods:"078915030900")

The output of these calls is the JSON as returned by the API.

From the command line

Thanks to the awesome python package parse_this the Outpan API is accessible directly from the command line!!!

python --help

will give you the help message to know how to use it.

A quick overview of the previous methods we’ve already talked about:

python 123456789 get-product 0796435419035
python 123456789 name 0796435419035
python 123456789 attributes 0796435419035
python 123456789 images 0796435419035
python 123456789 videos 0796435419035

These command lines use the (fake) API key 123456789 to 1. Retrieve the full info of product 0796435419035 2. Retrieve the name of product 0796435419035 3. Retrieve the attributes of product 0796435419035 4. Retrieve the image links of product 0796435419035 5. Retrieve the video links of product 0796435419035

Beta API - available until July 1, 2015

The ``beta` version of the API <>`__ is still available via the OutpanApiBeta class that can be used in the same way as the previous class.

Creating or editing a product’s name

If you want to create a new object or edit an existing product you can use the method api.add_edit_product_name as showed below:

api.add_edit_product_name("078915030900", "new_name")

Note that this method does not return anything and will replace any existing name.

Creating or editing a product’s attribute

You can also edit or create a product’s attribute using the method add_edit_product_attribute as follow:

api.add_edit_product_attribute("078915030900", "attribute_name", "attribute_value")

Note that this method does not return anything and will replace any existing attribute.


outpan can be installed using the following command:

pip install outpan

or using easy_install:

easy_install outpan

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for outpan, version 1.1.1
Filename, size File type Python version Upload date Hashes
Filename, size outpan-1.1.1.tar.gz (5.0 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page