# reverb API

> reverb API on Apizie: 163 endpoints (GET /articles, List of all article categories, List of supported product categories, GET /categories/flat, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/ecommerce:reverb/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `ecommerce:reverb`
- Category: E-commerce
- Status: byok
- Source: https://www.reverb-api.com
- Page: https://apizie.tech/api/ecommerce/reverb
- OpenAPI: https://apizie.tech/api/ecommerce/reverb/openapi.json

reverb

## Endpoints

### GET /articles
`GET https://apizie.tech/v1/ecommerce:reverb/get-articles` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| page | integer | no |  |
| per_page | integer | no |  |
| offset | integer | no |  |
| query | string | no | What's being searched for |
| exclude_featured | integer | no | Number of featured articles to exclude |

### List of all article categories
`GET https://apizie.tech/v1/ecommerce:reverb/get-articles-categories` (byok)

### List of supported product categories
`GET https://apizie.tech/v1/ecommerce:reverb/get-categories` (byok)

### GET /categories/flat
`GET https://apizie.tech/v1/ecommerce:reverb/get-categories-flat` (byok)

### Full taxonomy tree of categories including middle categories
`GET https://apizie.tech/v1/ecommerce:reverb/get-categories-taxonomy` (byok)

### Get subcategory details
`GET https://apizie.tech/v1/ecommerce:reverb/get-categories-product-type-category` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| product_type | string | yes |  |
| category | string | yes |  |

### Get category details
`GET https://apizie.tech/v1/ecommerce:reverb/get-categories-uuid` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| uuid | string | yes |  |

### Returns a set of comparison shopping pages based on the current params
`GET https://apizie.tech/v1/ecommerce:reverb/get-comparison-shopping-pages` (byok)

### Show comparison shopping page
`GET https://apizie.tech/v1/ecommerce:reverb/get-comparison-shopping-pages-find` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | no | ID of the comparison shopping page |
| slug | string | no | Slug of the comparison shopping page |

### GET /comparison_shopping_pages/{id}
`GET https://apizie.tech/v1/ecommerce:reverb/get-comparison-shopping-pages-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Return new or used listings for a comparison shopping page
`GET https://apizie.tech/v1/ecommerce:reverb/get-comparison-shopping-pages-id-listings` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| condition | string | yes | Condition of the listing |
| page | integer | no |  |
| per_page | integer | no |  |
| offset | integer | no |  |

### View reviews of a comparison shopping page
`GET https://apizie.tech/v1/ecommerce:reverb/get-comparison-shopping-pages-id-reviews` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Make an offer to the other participant in the conversation
`POST https://apizie.tech/v1/ecommerce:reverb/post-conversations-conversation-id-offer` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| conversation_id | string | yes |  |
| body | object | no | JSON request body |

### Make an offer to the other participant in the conversation
`POST https://apizie.tech/v1/ecommerce:reverb/post-conversations-id-offer` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| body | object | no | JSON request body |

### Retrieve a list of country codes with corresponding subregions
`GET https://apizie.tech/v1/ecommerce:reverb/get-countries` (byok)

### Returns a set of comparison shopping pages based on the current params
`GET https://apizie.tech/v1/ecommerce:reverb/get-csps` (byok)

### GET /csps/categories
`GET https://apizie.tech/v1/ecommerce:reverb/get-csps-categories` (byok)

### Show comparison shopping page
`GET https://apizie.tech/v1/ecommerce:reverb/get-csps-find` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | no | ID of the comparison shopping page |
| slug | string | no | Slug of the comparison shopping page |

### GET /csps/{id}
`GET https://apizie.tech/v1/ecommerce:reverb/get-csps-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### GET /curated_sets/{slug}
`GET https://apizie.tech/v1/ecommerce:reverb/get-curated-sets-slug` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| slug | string | yes |  |

### List of supported display currencies for browsing listings
`GET https://apizie.tech/v1/ecommerce:reverb/get-currencies-display` (byok)

### List of supported listing currencies for shops
`GET https://apizie.tech/v1/ecommerce:reverb/get-currencies-listing` (byok)

### Feedback details
`GET https://apizie.tech/v1/ecommerce:reverb/get-feedback-feedback-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| feedback_id | string | yes |  |

### Get results from a handpicked collection
`GET https://apizie.tech/v1/ecommerce:reverb/get-handpicked-slug` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| slug | string | yes |  |
| query | string | no | Search query. |
| auction_price_max | number | no | Maximum current auction price |
| category | string | no | Category slug from /api/categories |
| product_type | string | no | Product type slug from /api/categories |
| conditions | array | no | Condition: all,new,b-stock,used,non-functioning,all-but-new,poor,fair,good,very-good,excellent,mint |
| decade | string | no | Decade: e.g. 1970s, early 70s |
| finish | string | no | Visual finish of the item, common for guitars |
| handmade | boolean | no | Handmade items only |
| item_city | string | no | City where item is located |
| item_country | string | no | DEPRECATED - Country code where item is located |
| item_region | string | no | Country code where item is located |
| item_state | string | no | State or region code where item is located |
| make | array | no | Make(s)/brand of item (e.g. Fender). Can take a single value or an array. |
| model | string | no | Model of item (e.g. Stratocaster) |
| must_not | string | no | Search term negation. If you want to exclude a term, add it here |
| price_max | number | no | Maximum price of search results (USD) |
| price_min | number | no | Minimum price of search results (USD) |
| currency | string | no | The currency to be used for the price filters |
| year_max | integer | no | Maximum year of manufacture |
| year_min | integer | no | Minumum year of manufacture |
| accepts_gift_cards | boolean | no | If true, include only items that accept gift cards |
| preferred_seller | boolean | no | If true, include only items by Reverb Preferred Sellers |
| shop | string | no | Slug of shop to search |
| shop_id | string | no | ID of shop to search |
| listing_type | string | no | Type of listing: auctions,offers |
| ships_to | string | no | Limit search to items that ship to this country code |
| exclude_auctions | boolean | no | If true, exclude auctions |
| accepts_payment_plans | boolean | no | If true, only show items that can be purchased with a payment plan |
| watchers_count_min | integer | no | Minimum number of watchers (used to find popular items) |
| not_ids | array | no | Listing ID negation. If you want to exclude a listing, add it here. |
| local_pickup | boolean | no | Only items that offer local pickup |
| page | integer | no |  |
| per_page | integer | no |  |
| offset | integer | no |  |

### List of supported product conditions
`GET https://apizie.tech/v1/ecommerce:reverb/get-listing-conditions` (byok)

### Default search of listings includes only used & handmade. Add a filter to view all listings or use the…
`GET https://apizie.tech/v1/ecommerce:reverb/get-listings` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | no | Search query. |
| auction_price_max | number | no | Maximum current auction price |
| category | string | no | Category slug from /api/categories |
| product_type | string | no | Product type slug from /api/categories |
| conditions | array | no | Condition: all,new,b-stock,used,non-functioning,all-but-new,poor,fair,good,very-good,excellent,mint |
| decade | string | no | Decade: e.g. 1970s, early 70s |
| finish | string | no | Visual finish of the item, common for guitars |
| handmade | boolean | no | Handmade items only |
| item_city | string | no | City where item is located |
| item_country | string | no | DEPRECATED - Country code where item is located |
| item_region | string | no | Country code where item is located |
| item_state | string | no | State or region code where item is located |
| make | array | no | Make(s)/brand of item (e.g. Fender). Can take a single value or an array. |
| model | string | no | Model of item (e.g. Stratocaster) |
| must_not | string | no | Search term negation. If you want to exclude a term, add it here |
| price_max | number | no | Maximum price of search results (USD) |
| price_min | number | no | Minimum price of search results (USD) |
| currency | string | no | The currency to be used for the price filters |
| year_max | integer | no | Maximum year of manufacture |
| year_min | integer | no | Minumum year of manufacture |
| accepts_gift_cards | boolean | no | If true, include only items that accept gift cards |
| preferred_seller | boolean | no | If true, include only items by Reverb Preferred Sellers |
| shop | string | no | Slug of shop to search |
| shop_id | string | no | ID of shop to search |
| listing_type | string | no | Type of listing: auctions,offers |
| ships_to | string | no | Limit search to items that ship to this country code |
| exclude_auctions | boolean | no | If true, exclude auctions |
| accepts_payment_plans | boolean | no | If true, only show items that can be purchased with a payment plan |
| watchers_count_min | integer | no | Minimum number of watchers (used to find popular items) |
| not_ids | array | no | Listing ID negation. If you want to exclude a listing, add it here. |
| local_pickup | boolean | no | Only items that offer local pickup |
| page | integer | no |  |
| per_page | integer | no |  |
| offset | integer | no |  |

### Create a listing
`POST https://apizie.tech/v1/ecommerce:reverb/post-listings` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### All listings including used, handmade, and brand new
`GET https://apizie.tech/v1/ecommerce:reverb/get-listings-all` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | no | Search query. |
| auction_price_max | number | no | Maximum current auction price |
| category | string | no | Category slug from /api/categories |
| product_type | string | no | Product type slug from /api/categories |
| conditions | array | no | Condition: all,new,b-stock,used,non-functioning,all-but-new,poor,fair,good,very-good,excellent,mint |
| decade | string | no | Decade: e.g. 1970s, early 70s |
| finish | string | no | Visual finish of the item, common for guitars |
| handmade | boolean | no | Handmade items only |
| item_city | string | no | City where item is located |
| item_country | string | no | DEPRECATED - Country code where item is located |
| item_region | string | no | Country code where item is located |
| item_state | string | no | State or region code where item is located |
| make | array | no | Make(s)/brand of item (e.g. Fender). Can take a single value or an array. |
| model | string | no | Model of item (e.g. Stratocaster) |
| must_not | string | no | Search term negation. If you want to exclude a term, add it here |
| price_max | number | no | Maximum price of search results (USD) |
| price_min | number | no | Minimum price of search results (USD) |
| currency | string | no | The currency to be used for the price filters |
| year_max | integer | no | Maximum year of manufacture |
| year_min | integer | no | Minumum year of manufacture |
| accepts_gift_cards | boolean | no | If true, include only items that accept gift cards |
| preferred_seller | boolean | no | If true, include only items by Reverb Preferred Sellers |
| shop | string | no | Slug of shop to search |
| shop_id | string | no | ID of shop to search |
| listing_type | string | no | Type of listing: auctions,offers |
| ships_to | string | no | Limit search to items that ship to this country code |
| exclude_auctions | boolean | no | If true, exclude auctions |
| accepts_payment_plans | boolean | no | If true, only show items that can be purchased with a payment plan |
| watchers_count_min | integer | no | Minimum number of watchers (used to find popular items) |
| not_ids | array | no | Listing ID negation. If you want to exclude a listing, add it here. |
| local_pickup | boolean | no | Only items that offer local pickup |
| page | integer | no |  |
| per_page | integer | no |  |
| offset | integer | no |  |

### Individual facets
`GET https://apizie.tech/v1/ecommerce:reverb/get-listings-facets-seller-location` (byok)

### Returns the latest negotiation for the requesting user given a listing id
`GET https://apizie.tech/v1/ecommerce:reverb/get-listings-id-negotiation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Make an offer to the seller of a listing
`POST https://apizie.tech/v1/ecommerce:reverb/post-listings-id-offer` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| body | object | no | JSON request body |

### View available bump tiers and stats for a listing
`GET https://apizie.tech/v1/ecommerce:reverb/get-listings-listing-id-bump` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| listing_id | string | yes |  |

### Bump a listing
`POST https://apizie.tech/v1/ecommerce:reverb/post-listings-listing-id-bump-budget-type` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| listing_id | string | yes |  |
| budget_type | string | yes |  |

### Start a conversation with a seller
`POST https://apizie.tech/v1/ecommerce:reverb/post-listings-listing-id-conversations` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| listing_id | string | yes |  |
| body | object | no | JSON request body |

### View the images associated with a particular listing
`GET https://apizie.tech/v1/ecommerce:reverb/get-listings-listing-id-images` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| listing_id | string | yes |  |

### Delete an image from a listing
`POST https://apizie.tech/v1/ecommerce:reverb/delete-listings-listing-id-images-image-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| listing_id | string | yes |  |
| image_id | string | yes |  |

### See all sales that include a listing.
`GET https://apizie.tech/v1/ecommerce:reverb/get-listings-listing-id-sales` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| listing_id | string | yes |  |

### Listing details
`GET https://apizie.tech/v1/ecommerce:reverb/get-listings-slug` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| slug | string | yes |  |

### Update a listing
`POST https://apizie.tech/v1/ecommerce:reverb/put-listings-slug` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| slug | string | yes |  |
| body | object | no | JSON request body |

### Delete a draft listing. Cannot be used on non-drafts.
`POST https://apizie.tech/v1/ecommerce:reverb/delete-listings-slug` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| slug | string | yes |  |

### Edit listing.
`GET https://apizie.tech/v1/ecommerce:reverb/get-listings-slug-edit` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| slug | string | yes |  |

### Flag a listing for inappropriate content or fraud
`POST https://apizie.tech/v1/ecommerce:reverb/post-listings-slug-flag` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| slug | string | yes |  |
| body | object | no | JSON request body |

### View reviews of a listing
`GET https://apizie.tech/v1/ecommerce:reverb/get-listings-slug-reviews` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| slug | string | yes |  |

### Create a review for a listing
`POST https://apizie.tech/v1/ecommerce:reverb/post-listings-slug-reviews` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| slug | string | yes |  |

### Listing details
`GET https://apizie.tech/v1/ecommerce:reverb/get-listings-slug-similar-listings` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| slug | string | yes |  |

### Get account details
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-account` (byok)

### Update account details
`POST https://apizie.tech/v1/ecommerce:reverb/put-my-account` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### See all addresses in your address book
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-addresses` (byok)

### Create a new address in your address book
`POST https://apizie.tech/v1/ecommerce:reverb/post-my-addresses` (byok)

### Update an existing address in your address book
`POST https://apizie.tech/v1/ecommerce:reverb/put-my-addresses-address-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| address_id | string | yes |  |

### Delete an existing address in your address book
`POST https://apizie.tech/v1/ecommerce:reverb/delete-my-addresses-address-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| address_id | string | yes |  |

### Get a list of your conversations
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-conversations` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| search | string | no | Query string to search conversations by |
| unread_only | boolean | no | Show unread conversations only |
| page | integer | no |  |
| per_page | integer | no |  |
| offset | integer | no |  |

### Start a conversation
`POST https://apizie.tech/v1/ecommerce:reverb/post-my-conversations` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Send a message
`POST https://apizie.tech/v1/ecommerce:reverb/post-my-conversations-conversation-id-messages` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| conversation_id | string | yes |  |
| body | object | no | JSON request body |

### Display conversation details with messages in natural time order (oldest to newest)
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-conversations-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Mark a conversation read/unread
`POST https://apizie.tech/v1/ecommerce:reverb/put-my-conversations-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| body | object | no | JSON request body |

### Get your actionable status counts
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-counts` (byok)

### POST /my/curated_set/product/{product_id}
`POST https://apizie.tech/v1/ecommerce:reverb/post-my-curated-set-product-product-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| product_id | string | yes |  |

### DELETE /my/curated_set/product/{product_id}
`POST https://apizie.tech/v1/ecommerce:reverb/delete-my-curated-set-product-product-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| product_id | string | yes |  |

### Get listings from your feed
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-feed` (byok)

### get your feed customization options
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-feed-customize` (byok)

### get your feed
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-feed-grid` (byok)

### List of received feedback
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-feedback-received` (byok)

### List of sent feedback
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-feedback-sent` (byok)

### See what the user is following
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-follows` (byok)

### Returns a user's ArticleCategoryFollows
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-follows-articles` (byok)

### Set a user's ArticleCategoryFollows
`POST https://apizie.tech/v1/ecommerce:reverb/post-my-follows-articles` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Follow status for a brand
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-follows-brands-slug` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| slug | string | yes |  |

### Follow a brand
`POST https://apizie.tech/v1/ecommerce:reverb/post-my-follows-brands-slug` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| slug | string | yes |  |

### Unfollow a brand
`POST https://apizie.tech/v1/ecommerce:reverb/delete-my-follows-brands-slug` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| slug | string | yes |  |

### Follow status for a subcategory
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-follows-categories-category-subcategory` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| category | string | yes |  |
| subcategory | string | yes |  |

### Follow a subcategory
`POST https://apizie.tech/v1/ecommerce:reverb/post-my-follows-categories-category-subcategory` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| category | string | yes |  |
| subcategory | string | yes |  |

### Unfollow a subcategory
`POST https://apizie.tech/v1/ecommerce:reverb/delete-my-follows-categories-category-subcategory` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| category | string | yes |  |
| subcategory | string | yes |  |

### Follow status for a category
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-follows-categories-identifier` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| identifier | string | yes |  |

### Follow a category
`POST https://apizie.tech/v1/ecommerce:reverb/post-my-follows-categories-identifier` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| identifier | string | yes |  |

### Unfollow a category
`POST https://apizie.tech/v1/ecommerce:reverb/delete-my-follows-categories-identifier` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| identifier | string | yes |  |

### Follow a category
`POST https://apizie.tech/v1/ecommerce:reverb/post-my-follows-categories-uuid` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| uuid | string | yes |  |

### Follow status for a collection
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-follows-collections-slug` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| slug | string | yes |  |

### Follow a collection
`POST https://apizie.tech/v1/ecommerce:reverb/post-my-follows-collections-slug` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| slug | string | yes |  |

### Unfollow a collection
`POST https://apizie.tech/v1/ecommerce:reverb/delete-my-follows-collections-slug` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| slug | string | yes |  |

### Follow status for a handpicked collection
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-follows-handpicked-slug` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| slug | string | yes |  |

### Follow a handpicked collection
`POST https://apizie.tech/v1/ecommerce:reverb/post-my-follows-handpicked-slug` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| slug | string | yes |  |

### Unfollow a handpicked collection
`POST https://apizie.tech/v1/ecommerce:reverb/delete-my-follows-handpicked-slug` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| slug | string | yes |  |

### Follow status for a search
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-follows-search` (byok)

### Follow a search
`POST https://apizie.tech/v1/ecommerce:reverb/post-my-follows-search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Follow status for a shop
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-follows-shops-slug` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| slug | string | yes |  |

### Follow a shop
`POST https://apizie.tech/v1/ecommerce:reverb/post-my-follows-shops-slug` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| slug | string | yes |  |

### Unfollow a shop
`POST https://apizie.tech/v1/ecommerce:reverb/delete-my-follows-shops-slug` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| slug | string | yes |  |

### Delete a follow
`POST https://apizie.tech/v1/ecommerce:reverb/delete-my-follows-follow-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| follow_id | string | yes |  |

### POST /my/follows/{follow_id}/alert
`POST https://apizie.tech/v1/ecommerce:reverb/post-my-follows-follow-id-alert` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| follow_id | string | yes |  |

### DELETE /my/follows/{follow_id}/alert
`POST https://apizie.tech/v1/ecommerce:reverb/delete-my-follows-follow-id-alert` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| follow_id | string | yes |  |

### Retrieve a list of live listings for the seller. To search all listings specify state=all
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-listings` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | no | Search query. |
| auction_price_max | number | no | Maximum current auction price |
| category | string | no | Category slug from /api/categories |
| product_type | string | no | Product type slug from /api/categories |
| conditions | array | no | Condition: all,new,b-stock,used,non-functioning,all-but-new,poor,fair,good,very-good,excellent,mint |
| decade | string | no | Decade: e.g. 1970s, early 70s |
| finish | string | no | Visual finish of the item, common for guitars |
| handmade | boolean | no | Handmade items only |
| item_city | string | no | City where item is located |
| item_country | string | no | DEPRECATED - Country code where item is located |
| item_region | string | no | Country code where item is located |
| item_state | string | no | State or region code where item is located |
| make | array | no | Make(s)/brand of item (e.g. Fender). Can take a single value or an array. |
| model | string | no | Model of item (e.g. Stratocaster) |
| must_not | string | no | Search term negation. If you want to exclude a term, add it here |
| price_max | number | no | Maximum price of search results (USD) |
| price_min | number | no | Minimum price of search results (USD) |
| currency | string | no | The currency to be used for the price filters |
| year_max | integer | no | Maximum year of manufacture |
| year_min | integer | no | Minumum year of manufacture |
| accepts_gift_cards | boolean | no | If true, include only items that accept gift cards |
| preferred_seller | boolean | no | If true, include only items by Reverb Preferred Sellers |
| shop | string | no | Slug of shop to search |
| shop_id | string | no | ID of shop to search |
| listing_type | string | no | Type of listing: auctions,offers |
| ships_to | string | no | Limit search to items that ship to this country code |
| exclude_auctions | boolean | no | If true, exclude auctions |
| accepts_payment_plans | boolean | no | If true, only show items that can be purchased with a payment plan |
| watchers_count_min | integer | no | Minimum number of watchers (used to find popular items) |
| not_ids | array | no | Listing ID negation. If you want to exclude a listing, add it here. |
| local_pickup | boolean | no | Only items that offer local pickup |
| state | string | no | Available: ["all", "draft", "ended", "live", "ordered", "sold_out", "suspended", "seller_unavailable"]. Defaults to 'live' |
| sku | string | no | Find a listing by sku |

### Retrieve a list your draft listings
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-listings-drafts` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | no | Search query. |
| auction_price_max | number | no | Maximum current auction price |
| category | string | no | Category slug from /api/categories |
| product_type | string | no | Product type slug from /api/categories |
| conditions | array | no | Condition: all,new,b-stock,used,non-functioning,all-but-new,poor,fair,good,very-good,excellent,mint |
| decade | string | no | Decade: e.g. 1970s, early 70s |
| finish | string | no | Visual finish of the item, common for guitars |
| handmade | boolean | no | Handmade items only |
| item_city | string | no | City where item is located |
| item_country | string | no | DEPRECATED - Country code where item is located |
| item_region | string | no | Country code where item is located |
| item_state | string | no | State or region code where item is located |
| make | array | no | Make(s)/brand of item (e.g. Fender). Can take a single value or an array. |
| model | string | no | Model of item (e.g. Stratocaster) |
| must_not | string | no | Search term negation. If you want to exclude a term, add it here |
| price_max | number | no | Maximum price of search results (USD) |
| price_min | number | no | Minimum price of search results (USD) |
| currency | string | no | The currency to be used for the price filters |
| year_max | integer | no | Maximum year of manufacture |
| year_min | integer | no | Minumum year of manufacture |
| accepts_gift_cards | boolean | no | If true, include only items that accept gift cards |
| preferred_seller | boolean | no | If true, include only items by Reverb Preferred Sellers |
| shop | string | no | Slug of shop to search |
| shop_id | string | no | ID of shop to search |
| listing_type | string | no | Type of listing: auctions,offers |
| ships_to | string | no | Limit search to items that ship to this country code |
| exclude_auctions | boolean | no | If true, exclude auctions |
| accepts_payment_plans | boolean | no | If true, only show items that can be purchased with a payment plan |
| watchers_count_min | integer | no | Minimum number of watchers (used to find popular items) |
| not_ids | array | no | Listing ID negation. If you want to exclude a listing, add it here. |
| local_pickup | boolean | no | Only items that offer local pickup |

### Get a list of active negotiations as a seller
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-listings-negotiations` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| page | integer | no |  |
| per_page | integer | no |  |
| offset | integer | no |  |

### End a listing
`POST https://apizie.tech/v1/ecommerce:reverb/put-my-listings-slug-state-end` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| slug | string | yes |  |
| body | object | no | JSON request body |

### Get a list of your lists (wishlist, watch list, etc)
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-lists` (byok)

### Get a list of active negotiations as a buyer
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-negotiations-buying` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| page | integer | no |  |
| per_page | integer | no |  |
| offset | integer | no |  |

### Get offer details
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-negotiations-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Accept an offer
`POST https://apizie.tech/v1/ecommerce:reverb/post-my-negotiations-id-accept` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| body | object | no | JSON request body |

### Counter an offer
`POST https://apizie.tech/v1/ecommerce:reverb/post-my-negotiations-id-counter` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| body | object | no | JSON request body |

### Decline an offer
`POST https://apizie.tech/v1/ecommerce:reverb/post-my-negotiations-id-decline` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### List of orders that need feedback
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-orders-awaiting-feedback` (byok)

### Returns all orders, newest first.
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-orders-buying-all` (byok)

### GET /my/orders/buying/by_uuid/{uuid}
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-orders-buying-by-uuid-uuid` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| uuid | string | yes |  |

### Returns unpaid orders, newest first.
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-orders-buying-unpaid` (byok)

### Returns order details for a buyer
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-orders-buying-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Marks an order as received by the buyer
`POST https://apizie.tech/v1/ecommerce:reverb/post-my-orders-buying-id-mark-received` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Get all seller orders, newest first.
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-orders-selling-all` (byok)

### Get unpaid seller orders, newest first.
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-orders-selling-awaiting-shipment` (byok)

### See previous orders from buyer
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-orders-selling-buyer-history-buyer-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| buyer_id | string | yes |  |

### GET /my/orders/selling/by_uuid/{uuid}
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-orders-selling-by-uuid-uuid` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| uuid | string | yes |  |

### Get unpaid seller orders, newest first.
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-orders-selling-unpaid` (byok)

### Returns order details for a seller
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-orders-selling-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Marks an order as picked up
`POST https://apizie.tech/v1/ecommerce:reverb/post-my-orders-selling-id-mark-picked-up` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| body | object | no | JSON request body |

### Marks an order as shipped
`POST https://apizie.tech/v1/ecommerce:reverb/post-my-orders-selling-id-ship` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| body | object | no | JSON request body |

### Initiate a refund for a sold order
`POST https://apizie.tech/v1/ecommerce:reverb/post-my-orders-selling-order-id-refund-requests` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| order_id | string | yes |  |

### Get payments
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-payments-selling` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| page | integer | no |  |
| per_page | integer | no |  |
| offset | integer | no |  |
| created_start_date | string | no | Filter by date created in ISO8601 format - e.g: 2015-04-09T10:52:23-00:00 |
| created_end_date | string | no | Filter by date created in ISO8601 format - e.g: 2015-04-09T10:52:23-00:00 |
| updated_start_date | string | no | Filter by date modified in ISO8601 format - e.g: 2015-04-09T10:52:23-00:00 |
| updated_end_date | string | no | Filter by date modified in ISO8601 format - e.g: 2015-04-09T10:52:23-00:00 |
| order_id | string | no | Look up payments by order id |

### Get payment
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-payments-selling-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Get a list of payouts
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-payouts` (byok)

### Read the line items of a payout
`GET https://apizie.tech/v1/ecommerce:reverb/get-my-payouts-id-line-items` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

…and 43 more. See the OpenAPI spec.

## Example
```
curl "https://apizie.tech/v1/ecommerce:reverb/get-articles" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the reverb API?
Create a free Apizie key, then send GET https://apizie.tech/v1/ecommerce:reverb/get-articles with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the reverb API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. reverb itself also needs your own key from reverb.com.

### Can AI agents use the reverb API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key ecommerce:reverb.

### What is the status of the reverb API?
Needs your own provider key (bring your own key)