Response

The response for the Seller Profile operation is designed to provide a transparent view of a merchant business identity and historical performance. Every request returns a structured JSON object containing verified legal data, performance metrics, and recent feedback entries.

API Response Structure Overview

The JSON response is organized into four primary sections:

• request_info: Contains the status of the API call, unique request ID, and detailed credit consumption info.

• request_parameters: Echoes back the parameters you sent such as seller id or url to confirm what was processed.

• request_metadata: Timestamps regarding when the request was created and processed.

• result: The core payload containing the merchant identification, feedback metrics, and customer reviews.

1. Top Level Meta Fields (Outside of result)

These fields provide essential information about the transaction status, parameters, and processing timing.

request_info (object)

This object tracks the execution status and your account credit balance.

Field	Type	Description
id	String	A unique identifier assigned to this specific request for tracking.
success	Boolean	Indicates if the operation was completed successfully.
status_code	Number	The standard HTTP response code for the request.
credits_used	Number	The total amount of credits deducted for this individual request.
credits_remaining	Number	Your updated total credit balance after the consumption.

request_parameters (object)

Echoes the input values provided in the initial request.

Field	Type	Description
seller_id	String	The unique ID of the target seller processed by the system.
type	String	The operation type which is set to SELLER_PROFILE.
language	String	The language code used for the marketplace request.

request_metadata (object)

Provides technical timestamps for the request lifecycle.

Field	Type	Description
created_at	String	The exact timestamp when the request was received.
processed_at	String	The timestamp when the data extraction was completed.
total_time_taken	Number	Duration in seconds to complete the entire operation.

2. Core Payload (Inside result)

The result object contains the specific merchant data retrieved from the marketplace.

seller_details (object)

This section reveals the public and legal identification of the merchant.

Field	Type	Description
name	String	The public name of the store as displayed on the marketplace.
about_this_seller	String	Detailed information including legal business names and registered addresses.
rating	Number	The average star rating of the seller on a scale of five.
ratings_total	Number	The total count of ratings the seller has received over time.
store_link	String	The direct URL to the seller storefront on the platform.

feedback_summary (array)

Provides a statistical breakdown of seller performance across different timeframes.

Period	Description
thirty_days	Customer satisfaction metrics for the most recent month.
ninety_days	Performance data covering the last quarter.
twelve_months	Annual performance summary including feedback counts.
lifetime	The complete career history of the merchant.

feedback (array)

A list of the latest customer reviews left for the seller.

Field	Type	Description
body	String	The actual text content of the customer feedback.
rating	String	The star rating given by the customer for that specific order.
rater	String	The name of the reviewer combined with the date of the post.
is_strikethrough	Boolean	Indicates if Amazon has struck through this feedback due to fulfillment issues.

Main Result Fields

These fields provide the geographic context and direct communication links.

Field	Type	Description
country_code	String	The ISO country code of the marketplace where the profile was retrieved.
ask_a_question	String	The direct URL to the Amazon contact page for this specific seller.

Sample JSON Output

{
  "request_info": {
    "id": "04017e78-1efa-4255-80e4-7eac35dc8e14",
    "success": true,
    "status_code": 200,
    "credits_used": 1,
    "credits_remaining": 1999999999
  },
  "request_parameters": {
    "seller_id": "A23X8TYK8IHNZF",
    "type": "SELLER_PROFILE",
    "language": "en_CA"
  },
  "request_metadata": {
    "created_at": "2026-02-08T21:19:26.065Z",
    "processed_at": "2026-02-08T21:19:30.689Z",
    "total_time_taken": 4.624
  },
  "result": {
    "seller_details": {
      "name": "Layger",
      "about_this_seller": "Business Name: Layger Inc., Address: 456 Merchant Ave, Toronto, ON",
      "rating": 4.3,
      "ratings_total": 2660,
      "store_link": "https://www.amazon.ca/s?me=A23X8TYK8IHNZF"
    },
    "feedback_summary": [
      {
        "thirty_days": {
          "positive_percent": 70.72,
          "negative_percent": 28.18,
          "count": 181
        },
        "twelve_months": {
          "positive_percent": 83.01,
          "negative_percent": 15.94,
          "count": 2660
        }
      }
    ],
    "feedback": [
      {
        "body": "Never received item. Seller refunded without explanation",
        "rating": "1.0",
        "rater": "By Brad Parke on February 8, 2026.",
        "is_strikethrough": false
      }
    ],
    "ask_a_question": "https://amazon.ca/gp/help/contact-seller/...",
    "country_code": "CA"
  }
}