reverb-python 0.1.0

Python CLI and client library for the Reverb.com API

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

Command	Description
reverb listings list	Your live listings
reverb listings list --ownership all --query "fender jazz"	Search all listings
reverb listings list --state all	Include sold listings
reverb listings list --ownership drafts	Your drafts
reverb listings list --condition excellent --price-min 500	Filter by condition/price
reverb listings list --fields title --fields price	Choose columns
reverb listings list --output json	JSON output

Orders

Command	Description
reverb orders list	Your selling orders
reverb orders list --side buying	Your purchases
reverb orders list --status awaiting_shipment	Needs shipping
reverb orders list --status awaiting_feedback	Needs feedback
reverb orders list --limit 10	Limit results

Feedback

Command	Description
reverb feedback list	Received feedback
reverb feedback list --direction sent	Feedback you've left

Conversations

Command	Description
reverb conversations list	All conversations
reverb conversations list --unread-only	Unread only
reverb conversations list --search "jazz bass"	Search

Payouts

Command	Description
reverb payouts list	All payouts

Products & Price Guide

Command	Description
reverb products search --query "Telecaster"	Search product catalog
reverb products search --make Fender --query "American Vintage 62 Precision Bass"	Narrow by brand
reverb products price-guide <id>	Price history for a product
reverb products price-guide <id> --condition used --number-of-months 12	Longer price history

Account

Command	Description
reverb account show	Profile details
reverb account counts	Actionable item counts
reverb account addresses	Saved addresses

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.