Amazon Seller Profile API

Endpoint

GET /v1/amazon/seller

Parameters

seller_id *

Amazon seller ID (e.g. A2L77EE7U53NWQ), from a product's main_buy_box or an Amazon seller URL

country

Marketplace country code (default: us)

Response fields

seller

Seller profile object

seller.seller_id

Seller ID

seller.name

Seller display name

seller.seller_link

Seller profile URL

seller.store_link

Seller storefront URL

seller.logo

Seller logo URL (else null)

seller.about

About-this-seller text (else null)

seller.business_name

Registered business name

seller.business_address

Registered business address

seller.rating

Average rating, 0.0-5.0

seller.ratings_total

Total ratings count

seller.positive_percentage

Percentage of positive feedback

seller.review_summary

Feedback breakdown for thirty_days, ninety_days, twelve_months, lifetime — each with positive_percent, neutral_percent, negative_percent, count

seller.country

Marketplace country

Example Request

curl "https://apidirect.io/v1/amazon/seller?seller_id=A2L77EE7U53NWQ" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://apidirect.io/v1/amazon/seller",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"seller_id": "A2L77EE7U53NWQ"}
)
print(response.json())

Example Response

{
  "seller": {
    "seller_id": "A2L77EE7U53NWQ",
    "name": "Amazon Resale",
    "seller_link": "https://www.amazon.com/sp?seller=A2L77EE7U53NWQ",
    "store_link": "https://www.amazon.com/s?ie=UTF8&marketplaceID=ATVPDKIKX0DER&me=A2L77EE7U53NWQ",
    "logo": "https://m.media-amazon.com/images/I/01RxYGCdstL.gif",
    "about": "Quality used, pre-owned, or open box products, tested and inspected.",
    "business_name": "Amazon.com Services LLC",
    "business_address": "410 Terry Ave N Seattle WA 98109 US",
    "rating": 4.2,
    "ratings_total": 2593,
    "positive_percentage": 79,
    "review_summary": {
      "thirty_days": {"positive_percent": 75, "neutral_percent": 1, "negative_percent": 23, "count": 89},
      "ninety_days": {"positive_percent": 78, "neutral_percent": 1, "negative_percent": 21, "count": 232},
      "twelve_months": {"positive_percent": 79, "neutral_percent": 2, "negative_percent": 19, "count": 812},
      "lifetime": {"positive_percent": 82, "neutral_percent": 3, "negative_percent": 15, "count": 2593}
    },
    "country": "US"
  }
}

Frequently asked questions

Where do I find a seller_id?

From Product Details — main_buy_box.seller_id identifies who sells the product. It's also the seller= parameter in any Amazon seller page URL.

Why are rating fields null for some sellers?

Sellers without public feedback stats (including some of Amazon's own storefronts) return null for rating, ratings_total, and positive_percentage. The profile fields still populate.

What if the seller doesn't exist?

You get a 404 with code: "not_found".

How does pricing work?

You only pay for successful requests. The Amazon Seller Profile API costs $0.005 per request. There are no monthly fees or commitments. You get 50 free requests per endpoint every month.

Do I need a credit card to start?

No. You can sign up and use the free tier (50 requests/endpoint/month) without adding a payment method. You only need to add a card when you want to exceed the free tier.

Are there rate limits?

Yes, there's a concurrency limit of 5 simultaneous requests per endpoint per user. If you need more, just get in touch.