/mercari-python-api

The Python Mercari API.

Primary LanguagePython

The Python Mercari API

A Python interface to the unofficial Mercari API.

Documentation

Documentation is as follows.

Public endpoints

  • mercari.fetch_all_items(keyword='bike', price_max=None)

    • keyword: Keyword search.
    • price_max: Maximum price in Yen.
    • returns: Returns a list of item urls.

  • mercari.get_item_info(item_url='https://item.mercari.com/jp/m72639077322/')

    • item_url: The URL of the item. Returns from the fetch_all_items function.
    • returns: Item object (name, desc, price, is sold out...)

Private endpoints

  • Not implemented yet.

Installation

Simply run:

git clone git@github.com:philipperemy/mercari-python-api.git
cd mercari-python-api
virtualenv -p python3.6 venv3.6
pip install -r requirements.txt
python setup.py install

Monitoring

cp gmail_conf.json.example gmail_conf.json
vim gmail_conf.json # edit this file.
cd examples/
python3.6 -u monitor.py --keywords "road bike, moto bike" --max_prices "43000,43000" --min_prices "0,0"

Important

Amazon AWS IPs are blacklisted by Mercari. So don't use AWS EC2 to run this script, it will not work.