Skip to content

take-kun/mercapi

Repository files navigation

mercapi

PyPI Tests PyPI - Python Version

API Documentation

What is Mercapi?

Mercapi is a Python wrapper for mercari.jp API. It's capable of producing HTTP requests implementing security mechanisms employed in native mercari.jp web app. Requests and responses are mapped to custom classes with type-hinting and documentation.

Quickstart

First, install the mercapi package using the package manager of your choice.

As an example, we want to run the search query sharpnel.

from mercapi import Mercapi


m = Mercapi()
results = await m.search('sharpnel')

print(f'Found {results.meta.num_found} results')
for item in results.items:
    print(f'Name: {item.name}\\nPrice: {item.price}\\n')

We can use a single result object to retrieve full details of the listing.

item = results.items[0]
full_item = await item.full_item()

print(full_item.description)

Or get it directly using an ID.

item = await m.item('m90925725213')

print(item.description)

Refer to mercapi.mercapi.Mercapi documentation for all implemented features.

Examples above are not executable. If you want to try them out, run python example.py.

About

Python API for querying and browsing mercari.jp

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  

Languages