Response
The SELLER FEEDBACK operation returns a structured JSON response designed to provide clear visibility into a merchant's service history. The response is divided into metadata regarding your account's credit usage and the high-fidelity feedback data extracted from Amazon.
API Response Structure Overview
The root of the JSON response contains four primary objects that categorize the data.
request_info: Contains the request ID, success status, and credit consumption details.request_parameters: Echoes the parameters sent in your request (e.g.,seller_id,rating_range).request_metadata: Provides timestamps for when the request was created and processed.result: The main payload containing theseller_feedbackarray andpaginationdata.
These fields provide essential information about the transaction status, parameters, and processing timing.
1. Top Level Meta Fields (Outside of result)
These fields provide the technical context of your transaction, essential for debugging and monitoring account limits.
request_info (Object)
The request_info object provides the technical status of your API call and real-time updates on your credit usage.
id
String
The unique identifier for this specific API request.
success
Boolean
Indicates if the request was completed successfully.
status_code
Integer
The standard HTTP response status (e.g., 200).
credits_used
Integer
Total credits consumed by your account so far in the current period.
credit_used_this_request
Integer
The number of credits deducted for this specific operation.
credits_remaining
Integer
Your remaining credit balance.
credits_reset_at
String
The timestamp for when your credit quota will reset.
request_parameters (Object)
This object confirms the configuration used for the extraction, allowing you to verify that filters like rating and history were applied correctly.
seller_id
String
The target seller's identifier.
min_rating
Integer
The minimum star rating requested.
max_rating
Integer
The maximum star rating requested.
history_range
String
The selected time range (e.g., 1, 3, 12, or all).
request_metadata (Object)
The request_metadata object provides high-precision timestamps for the lifecycle of your request. This is particularly useful for auditing and calculating the total turnaround time of the data extraction.
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
Float
Duration in seconds to complete the entire operation.
2. Core Payload (Inside result)
The result object is the most critical part of the response, containing the data harvested from the Amazon seller feedback pages.
seller_feedback (Array)
This array contains the individual feedback entries. Each object represents a unique customer review of the seller.
body
String
The actual comment or review text left by the customer.
rating
Integer
The star rating assigned to the seller (1-5).
rater
String
The display name of the customer.
has_response
Boolean
Indicates if the seller has officially replied to this feedback.
date
Object
Contains raw (text) and timestamp (Unix) formats of the feedback date.
profile
Object
Includes the customer's avatar image and their Amazon profile url.
pagination (Array)
The pagination object provides the necessary metadata to crawl through multiple pages of feedback data.
current_page
Integer
The page number of the current results.
has_next_page
Boolean
If true, more results are available for extraction.
next_page
Integer
The index to use for the min_page parameter in your next request.
Sample JSON Output
Last updated