# 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

{% code overflow="wrap" %}

```json
{
  "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"
  }
}
```

{% endcode %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://easyparser.gitbook.io/easyparser-documentation/real-time-integration/seller-profile/response.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.