# Amazon Seller Profile API Documentation

<p><strong>Amazon Seller Profile API Documentation</strong> Read a public Amazon seller profile by seller id: name, legal business details and address, and the star histogram (count and percent per star) for 30 days, 90 days, 12 months and lifetime. The average rating and the positive percentage are calculated from the lifetime counts. Get seller ids from the offers endpoint.</p>

- **Documentation:** [https://scrappa.co/docs/amazon-api/amazon_seller](https://scrappa.co/docs/amazon-api/amazon_seller)
- **API group:** Amazon API
- **Endpoint:** `GET https://scrappa.co/api/amazon/seller/{sellerId}`

## 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 |
| --- | --- | --- | --- |
| `sellerId` | string | Yes | Seller id in the path. Example: A1N6INQ4SRJFXQ. |
| `domain` | string | No | Amazon marketplace. Supported here: US, DE. Default: US. |

## Example response

```json
{
    "data": {
        "name": "Goodwill Michiana",
        "domain": "US",
        "ratings": {
            "lifetime": {
                "stars": {
                    "1": {
                        "count": 390,
                        "percent": 1
                    },
                    "2": {
                        "count": 156,
                        "percent": 0
                    },
                    "3": {
                        "count": 338,
                        "percent": 1
                    },
                    "4": {
                        "count": 1805,
                        "percent": 5
                    },
                    "5": {
                        "count": 30975,
                        "percent": 92
                    }
                },
                "total": 33664
            }
        },
        "business": {
            "address": [
                "1805 W Western Ave",
                "SOUTH BEND",
                "IN",
                "46619",
                "US"
            ],
            "business_name": "Goodwill Industries of Michiana, Inc."
        },
        "seller_id": "A1N6INQ4SRJFXQ",
        "source_url": "https://www.amazon.com/sp?seller=A1N6INQ4SRJFXQ",
        "average_rating": 4.87,
        "positive_percent": 97
    },
    "meta": {
        "cached": false,
        "domain": "US",
        "currency": "USD",
        "language": "en_US",
        "timestamp": "2026-10-31T22:00:00.000000Z",
        "response_time_ms": 4200
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | The seller id is unknown on this marketplace. This response is not billable. |
| 503 | Service Unavailable | Amazon could not be reached after several tries. This response is not billable. Retry shortly. |

## 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)