Seller Profile Response

For Seller Profile, result contains the seller's identity and ratings, a feedback summary for four timeframes, the most recent feedback entries and the seller contact link. Every response uses the shared response envelope (request_info, request_parameters, request_metadata, result).

Response structure

result
├── seller_details
│   ├── name
│   ├── business_name
│   ├── business_address
│   ├── business_address_rows[]
│   ├── business_country
│   ├── about_this_seller
│   ├── detailed_information
│   ├── logo
│   ├── main_image { id, link }
│   ├── rating
│   ├── ratings_total
│   ├── ratings_total_percentage
│   └── store_link
├── feedback_summary
│   └── 1_month | 3_month | 12_month | all_time
│       └── 1_star .. 5_star, count
├── feedback[]
│   └── body, rating, rater, position, is_strikethrough, message_from_amazon
├── ask_a_question
├── country_code
└── not_match[]

Result fields

result

Field	Type	Description
seller_details	object	Seller identity and ratings. See below.
feedback_summary	object	Star distribution and feedback count per timeframe. See below.
feedback	array	Most recent feedback entries shown on the seller profile. See below.
ask_a_question	string	URL of the Amazon "Ask a question" contact page for this seller.
country_code	string	ISO 3166 alpha-2 code of the marketplace the data comes from, for example US.
not_match	array	Names of fields that could not be retrieved for this seller. Empty when every expected field was returned.

result.seller_details

Field	Type	Description
name	string	Store name shown to customers on the marketplace.
business_name	string	Registered business name.
business_address	string	Registered business address as one comma-separated string.
business_address_rows	array	Registered business address split into lines (array of strings).
business_country	string	Country code of the registered business, for example US.
about_this_seller	string	The seller's "About this seller" text. Not present for every seller.
detailed_information	string	Full "Detailed Seller Information" text, including the business name and address.
logo	string	URL of the seller logo.
main_image.id	string	Image ID of the seller logo.
main_image.link	string	URL of the seller logo.
rating	number	Average seller rating out of 5, for example 4.9.
ratings_total	integer	Number of ratings shown on the seller profile.
ratings_total_percentage	integer	Positive feedback percentage shown on the seller profile, for example 100.
store_link	string	URL of the seller's storefront.

result.feedback_summary

Field	Type	Description
1_month	object	Feedback for the last 1 month.
3_month	object	Feedback for the last 3 months.
12_month	object	Feedback for the last 12 months.
all_time	object	Feedback for the seller's full history.

Timeframe object

Each object in feedback_summary has the same fields.

Field	Type	Description
1_star	string	Share of 1-star feedback, with a percent sign, for example "1%".
2_star	string	Share of 2-star feedback, for example "0%".
3_star	string	Share of 3-star feedback, for example "1%".
4_star	string	Share of 4-star feedback, for example "4%".
5_star	string	Share of 5-star feedback, for example "94%".
count	integer	Number of feedback entries in the timeframe.

result.feedback[]

Field	Type	Description
body	string	Feedback comment text.
rating	string	Star rating as a numeric string, for example "4.0".
rater	string	Rater name and feedback date as one string, for example "By Buu Em Tran on August 24, 2026.".
position	integer	Zero-based position of the entry in the seller's feedback list.
is_strikethrough	boolean	true when Amazon struck through the feedback because Amazon handled the fulfillment.
message_from_amazon	string	Amazon's note on a struck-through entry. Present only when is_strikethrough is true.

Sample response

Sample response (SELLER_PROFILE, .com)

{
  "request_info": {
    "id": "1d757c8a-39bb-4623-bf0c-8e8680248d96",
    "success": true,
    "status_code": 200,
    "error_details": [],
    "credits_used": 9512,
    "credit_used_this_request": 1,
    "credits_remaining": 990488,
    "credits_reset_at": "2028-12-09T08:46:47.000Z",
    "address": {
      "city": null,
      "district": null,
      "country_code": null,
      "zipCode": ["19805"]
    }
  },
  "request_parameters": {
    "output": "json",
    "language": "en_US",
    "include_html": false,
    "seller_id": "AAK72K4OIWDXL",
    "type": "SELLER_PROFILE"
  },
  "request_metadata": {
    "created_at": "2026-08-24T13:41:25.179Z",
    "processed_at": "2026-08-24T13:41:26.232Z",
    "total_time_taken": 1.053
  },
  "result": {
    "seller_details": {
      "business_address": "11307 W MCFARLANE RD, STE 107, AIRWAY HEIGHTS, WA, 99001, US",
      "business_address_rows": ["11307 W MCFARLANE RD", "STE 107", "AIRWAY HEIGHTS", "WA", "99001", "US"],
      "business_country": "US",
      "business_name": "HUPPINS ONECALL",
      "detailed_information": "Detailed Seller Information Business Name: HUPPINS ONECALL Business Address: 11307 W MCFARLANE RD STE 107 AIRWAY HEIGHTS WA 99001 US",
      "logo": "https://m.media-amazon.com/images/I/01EQ+pWzelL.jpg",
      "main_image": {
        "id": "01EQ+pWzelL",
        "link": "https://m.media-amazon.com/images/I/01EQ+pWzelL.jpg"
      },
      "name": "Huppins",
      "rating": 4.9,
      "ratings_total": 1363,
      "ratings_total_percentage": 100,
      "store_link": "https://www.amazon.com/s?ie=UTF8&marketplaceID=ATVPDKIKX0DER&me=AAK72K4OIWDXL"
    },
    "feedback_summary": {
      "1_month": { "1_star": "1%", "2_star": "0%", "3_star": "1%", "4_star": "4%", "5_star": "94%", "count": 103 },
      "3_month": { "1_star": "0%", "2_star": "0%", "3_star": "0%", "4_star": "4%", "5_star": "96%", "count": 294 },
      "12_month": { "1_star": "0%", "2_star": "0%", "3_star": "0%", "4_star": "5%", "5_star": "95%", "count": 1363 },
      "all_time": { "1_star": "0%", "2_star": "0%", "3_star": "0%", "4_star": "6%", "5_star": "94%", "count": 42050 }
    },
    "feedback": [
      {
        "body": "Good delilery to me.",
        "is_strikethrough": false,
        "position": 0,
        "rater": "By Buu Em Tran on August 24, 2026.",
        "rating": "4.0"
      },
      {
        "body": "Item was supposed to be delivered yesterday. I'm not at that address anymore. Cancel the item.",
        "is_strikethrough": true,
        "message_from_amazon": "This item was fulfilled by Amazon, and we take responsibility for this fulfillment experience.",
        "position": 3,
        "rater": "By Amazon Customer on August 23, 2026.",
        "rating": "1.0"
      }
    ],
    "not_match": [],
    "ask_a_question": "https://amazon.com/gp/help/contact-seller/contact-seller.html?sellerID=AAK72K4OIWDXL&marketplaceID=ATVPDKIKX0DER&ref_=v_sp_contact_seller"
  }
}

Notes

Note

Not every field is available for every seller. When a field cannot be retrieved, it is left out of result and its name is listed in not_match.

• feedback_summary is an object keyed by timeframe (1_month, 3_month, 12_month, all_time) with 1 to 5 star percentages. Earlier versions returned it as an array with thirty_days, ninety_days, twelve_months and lifetime keys. If your integration still reads that array, update it to the object format.
• feedback[] holds only the recent entries shown on the profile. For paginated feedback with rating and time range filters, use Seller Feedback (SELLER_FEEDBACK).