reverb-python

A Python CLI and client library for Reverb's API.

Install

pip install reverb-python   # or: uv add reverb-python

The CLI and client authenticate with a Reverb personal access token, read from the REVERB_PERSONAL_ACCESS_TOKEN environment variable:

export REVERB_PERSONAL_ACCESS_TOKEN="your-token"
reverb --help

(Product search and price guide are public and need no token.)

Usage

CLI

Listings

Orders

Feedback

Conversations

Payouts

Products & Price Guide

Account

Client library

>>> from reverb_python.client import ReverbHttpClient
>>> from reverb_python.enums import ListingOwnership, PriceGuideCondition, ReverbEndpoint
>>> from reverb_python.schemas.listings import ListingSearchFilters

>>> client = ReverbHttpClient(personal_access_token="your-token")

>>> listings = client.get_listings(filters=ListingSearchFilters(query="fender jazz bass"), ownership=ListingOwnership.MINE)
>>> orders = client.get_orders(endpoint=ReverbEndpoint.MY_ORDERS_SELLING_ALL)
>>> feedback = client.get_feedback(endpoint=ReverbEndpoint.MY_FEEDBACK_RECEIVED)
>>> conversations = client.get_conversations(unread_only=True)
>>> payouts = client.get_payouts()
>>> account = client.get_account()
>>> counts = client.get_counts()
>>> products = client.search_comparison_shopping_pages(make="Fender", query="American Vintage 62 Precision Bass")
>>> price_guide = client.get_price_guide(product_id=products[0].id, condition=PriceGuideCondition.USED, number_of_months=12)

Development

See docs/DEVELOPMENT.md.