Target Product Reviews API Documentation Get the customer reviews of one Target product with the rating statistics. Each review has its rating, text, recommended and verified flags, incentivized flag, author nickname, dates, helpful votes, secondary ratings, badges, photos, videos and brand responses. The statistics have the average rating, the count per star, the positive and recommended percent and the average of each secondary rating. Sort by newest, highest rating, lowest rating or most helpful. Target has no star filter: sort by highest_rating or lowest_rating to read the best or the worst reviews first. The page number in the answer always matches the page you asked for. Cost: 1 credit per page, 2 credits when size is above 20. A product with no reviews and every error cost nothing.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
5 optional filters available.
string
Required
Target item number, 5 to 10 digits, e.g. 92538311.
example
string
Optional
most_recent, highest_rating, lowest_rating or helpfulness_desc. Default: most_recent. Target has no star filter: sort by rating instead.
relevance
integer
Optional
Page number, 1 to 100. Default: 1.
1
integer
Optional
Reviews per page, 1 to 50. Default: 8. Sizes above 20 cost 2 credits.
10
boolean
Optional
true to return reviews of verified purchases only. Default: false.
true
boolean
Optional
true to return reviews with photos only. Default: false.
true
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"sort": "most_recent",
"tcin": "92538311",
"results": [
{
"id": "a1227df2-b6dd-41aa-9a09-18cb693233d8",
"text": "My son loved doing this set.",
"title": null,
"author": "Mary",
"badges": [
"verifiedPurchaser"
],
"photos": [],
"rating": 5,
"source": "targetcom",
"videos": [],
"is_verified": true,
"modified_at": "2026-10-26T10:06:42.000+00:00",
"submitted_at": "2026-10-24T01:20:06.000+00:00",
"helpful_votes": 0,
"is_syndicated": false,
"is_recommended": true,
"is_incentivized": false,
"unhelpful_votes": 0,
"client_responses": [],
"secondary_ratings": [
{
"label": "quality",
"value": 5
}
]
}
],
"pagination": {
"size": 8,
"total_pages": 9,
"current_page": 1,
"has_next_page": true,
"total_results": 71
},
"statistics": {
"distribution": {
"1": 3,
"2": 1,
"3": 5,
"4": 13,
"5": 227
},
"rating_count": 249,
"review_count": 71,
"average_rating": 4.85,
"positive_percent": 98,
"recommended_count": 35,
"with_photos_count": 6,
"with_videos_count": 0,
"incentivized_count": 6,
"secondary_averages": [
{
"label": "quality",
"value": 4.82
}
],
"recommended_percent": 94,
"not_recommended_count": 2
}
},
"meta": {
"credits": 1,
"billable": true,
"duration_ms": 900,
"endpoint_family": "reviews"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A required query parameter is missing or invalid. This response is not billable.
{
"errors": {
"sort": [
"The sort is one of most_recent, highest_rating, lowest_rating, helpfulness_desc."
]
},
"message": "The request validation failed"
}Service Unavailable
Target could not be reached or refused the request. This response is not billable. Retry later.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "reviews"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Target is temporarily unavailable. Please retry."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.