# Reverb Listing API Documentation

<p><strong>Reverb Listing API Documentation</strong> Get one listing with full-size photos, price and shop detail. Prices are numbers with a currency, ids work unchanged in the next route, dates use ISO 8601 and images are full-size URLs. 1 credit per request. Failed requests are never billed. Shop rating_percentage is a fraction from 0 to 1, not a 0 to 100 percentage.</p>

- **Documentation:** [https://scrappa.co/docs/reverb-api/reverb_listing](https://scrappa.co/docs/reverb-api/reverb_listing)
- **API group:** Reverb API
- **Endpoint:** `GET https://scrappa.co/api/reverb/listing`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | No | Numeric listing id from a Reverb search result |

## Example response

```json
{
    "data": {
        "id": 101093375,
        "shop": {
            "slug": "rock-n-roll-vintage",
            "feedback_count": 20487,
            "rating_percentage": 0.998
        },
        "year": "1966",
        "price": {
            "amount": 2495,
            "currency": "USD",
            "amount_cents": 249500
        },
        "stats": {
            "views": 1420,
            "watches": 38
        },
        "title": "Fender Stratocaster 1966",
        "condition": {
            "slug": "very-good",
            "display_name": "Very Good"
        },
        "image_urls": [
            "https://rvb-img.reverb.com/i/example.jpg"
        ],
        "buyer_price": {
            "amount": 2549,
            "currency": "USD",
            "amount_cents": 254900
        }
    },
    "meta": {
        "endpoint_family": "listing"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing or invalid, or an unsupported filter was sent. Failed requests are not billed. |
| 404 | Not Found | The requested listing or shop does not exist. Failed requests are not billed. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
