---
title: Reviews
slug: redcircleapi/target-product-data-api/results/reviews
docTags:
createdAt: 2024-07-27T14:22:43.825Z
---
# Reviews Results
When making a request with the `type` [parameter](https://docs.trajectdata.com/redcircleapi/target-product-data-api/parameters/reviews) set to `type=reviews` RedCircle API will return all Customer Reviews for the product specified in the `tcin` , `dpci` or `url` parameter.
Reviews are retrieved from the [customer reviews page](https://www.target.com/p/-/A-78025470) for a single product on Target.
An example of the JSON object returned from a Reviews request is shown below:
```json
{
"request_info": {
"success": true,
"credits_used": 1,
"credits_remaining": 999
},
"request_metadata": {
"created_at": "2022-01-01T00:00:00.000Z",
"processed_at": "2022-01-01T00:00:00.001Z",
"total_time_taken": 0.1
},
"request_parameters": {
"type": "reviews",
"tcin": "78025470"
},
"reviews": [
{
"position": 1,
"id": "c6d8c3a7-2540-42ff-bc97-8cc6540a09a9",
"title": "Awesome",
"body": "Bright and last a long time. My kids use them as regular markers and they hold up.",
"date": "2021-03-10T17:22:50.000Z",
"rating": 5,
"positive_feedback": 1,
"source": {
"is_external_source": false,
"author_name": "SnakeDork",
"author_id": "1413799033",
"verified_purchase": true
}
},
{
"position": 2,
"id": "7b88d6d0-e9f2-4fe0-818c-334de2c6c9bb",
"title": "Work great",
"body": "[This review was collected as part of a promotion.] I use these highlighters on a daily basis and they’re still going strong. I went for this bigger pack because I have two desks at home so I can have the same colored highlighters at either spot without having to fetch from the other desk. These markers are always super vibrant and don’t bleed through regular copy paper.",
"date": "2021-02-10T15:22:27.000Z",
"rating": 5,
"source": {
"is_external_source": true,
"external_source": "Sharpie",
"syndication_source": "bazaarvoice",
"author_name": "Lishglam",
"author_id": "a931cbf1-c434-5ce4-8678-a7a49ce2a50c",
"verified_purchase": false
}
},
{
"position": 3,
"id": "9e674484-9e1f-4033-93b5-5f39f9773a85",
"title": "Works great!",
"body": "[This review was collected as part of a promotion.] I use highlighters all the time for my bills and my child uses them for school work and a lot of them run out or fade quickly. So far using the Sharpie highlighters they have worked great. The quality has been superb and I have been extremely happy with them. I have used all of them consistently throughout the month and they are all still as bright as they were in the beginning.",
"date": "2021-02-08T17:19:03.000Z",
"rating": 5,
"source": {
"is_external_source": true,
"external_source": "Sharpie",
"syndication_source": "bazaarvoice",
"author_name": "CresantM",
"author_id": "e4cbd19b-17a8-5187-acfc-7a32e1c8d8d4",
"verified_purchase": false
}
},
{
"position": 4,
"id": "6314329b-7d67-4d20-ad88-cab5a61849c9",
"title": "Dissapointed",
"body": "Two of the highlighters “tips” broke off while I was using them to highlight my school notes. Highlighters only lasted 1 week.",
"date": "2021-02-05T20:35:11.000Z",
"rating": 1,
"source": {
"is_external_source": false,
"author_name": "EBBEAN",
"author_id": "7975913997",
"verified_purchase": false
},
"main_image": "https://target.scene7.com/is/image/Target/GUEST_1e4f2325-3e56-4e88-a57d-5dab05b0f29c"
},
{
"position": 5,
"id": "4ea0d9ba-df06-4542-9eed-783663a2ddc0",
"title": "Bright and Vibrant!!!",
"body": "[This review was collected as part of a promotion.] I love these Sharpie highlighters. The colors are bright and vibrant. It’s easy to see the wording through the highlight. They are slimmer and easy to hold. With a few different colors, I can take notes and highlight according to importance. I love using them.",
"date": "2021-02-01T21:03:54.000Z",
"rating": 5,
"source": {
"is_external_source": true,
"external_source": "Sharpie",
"syndication_source": "bazaarvoice",
"author_name": "aja3ez",
"author_id": "8b9d4fd8-870e-519c-88f5-f30e39b31e64",
"verified_purchase": false
}
},
{
"position": 6,
"id": "70772581-4d6f-4466-91f8-bc318531fc38",
"title": "Sharpie highlighter",
"body": "The price for this 4 pack is unbeatable. And they last long.",
"date": "2021-01-31T20:44:03.000Z",
"rating": 5,
"positive_feedback": 1,
"source": {
"is_external_source": false,
"author_name": "MamaT",
"author_id": "7981599482",
"verified_purchase": true
}
},
{
"position": 7,
"id": "b597d54c-93e8-4b2e-8a00-2e2a8106ed25",
"title": "Great",
"body": "Perfect for school! Exactly what my child needed.",
"date": "2021-01-30T21:46:44.000Z",
"rating": 5,
"source": {
"is_external_source": false,
"author_name": "Target Fan",
"author_id": "433859762",
"verified_purchase": false
}
},
{
"position": 8,
"id": "ba962e3b-5311-4ce1-80cf-069f2f3830e0",
"title": "Bright colors !",
"body": "[This review was collected as part of a promotion.] The colors of these sharpies are very bright and really stand out. I like that they have the smear guard because it doesn't look messy. I also like that these highlighters are easier to hold than those bigger rounder highlighters.",
"date": "2021-01-29T17:47:13.000Z",
"rating": 5,
"source": {
"is_external_source": true,
"external_source": "Sharpie",
"syndication_source": "bazaarvoice",
"author_name": "Danieljoshua",
"author_id": "34f104bf-7b60-575a-8986-2ab85bf1b67c",
"verified_purchase": false
}
},
{
"position": 9,
"id": "8c43f345-6c87-44e4-9816-208412a7418b",
"title": "perfect colors",
"body": "[This review was collected as part of a promotion.] Sharpies have always been my favorite and I have that this pack comes with so many colors to use! It year helps when highlighting notes to study. These seem to work forever and never dry out. I love that they are also no smear.",
"date": "2021-01-27T02:47:08.000Z",
"rating": 5,
"source": {
"is_external_source": true,
"external_source": "Sharpie",
"syndication_source": "bazaarvoice",
"author_name": "ScottN",
"author_id": "5d867097-5767-52c7-9586-2fa7220f92ab",
"verified_purchase": false
}
},
{
"position": 10,
"id": "6eef1c79-3904-4399-a128-6735f93c5849",
"title": "Great colors!",
"body": "[This review was collected as part of a promotion.] These colors were a big hit in the office. We love yellow but we want COLOR. Quality Sharpie design! This set of highlighters is perfect for school, work or bible study. I will definitely buy these again!",
"date": "2021-01-26T21:56:36.000Z",
"rating": 5,
"source": {
"is_external_source": true,
"external_source": "Sharpie",
"syndication_source": "bazaarvoice",
"author_name": "itygfma",
"author_id": "cbcbdcf0-a272-59de-8b4f-f12840d13a29",
"verified_purchase": false
}
}
],
"summary": {
"rating": 4.7,
"ratings_total": 77,
"recommended_percentage": 87,
"rating_breakdown": {
"one_star": 6,
"two_star": 4,
"three_star": 6,
"four_star": 25,
"five_star": 200
}
},
"pagination": {
"current_page": 1,
"total_pages": 8,
"next_page": 2
}
}
```
RedCircle API returns the following properties for Reviews requests:
| `Property` | `Type` | `Description` |
| ------------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `reviews` | `array` | An array of Review objects, containing each of the Customer Reviews shown on the Customer Reviews page. The Review object has the following properties:
* `id`
* `string`
* The unique, Target-assigned, ID of the customer review. This can be used by your app to flag whether you have previously processed this review on a prior request.
* `title`
* `string`
* The title of the review.
* `body`
* `string`
* The body text of the review.
* `date`
* `string`
* The date of the review.
* `rating`
* `number`
* The rating, out of 5, given by the reviewer.
* `positive_feedback`
* `number`
* The number of times this review has been given positive feedback.
* `negative_feedback`
* `boolean`
* The number of times this review has been given negative feedback.
* `source`
* `object`
* **Review Source Object**
The `source` object contains details about the source and author of the review.
-
1. `is_external_source`
2. `boolean`
3. True/false whether the review was sourced from an external third-party.
-
1. `external_source`
2. `string`
3. The name of the external third-party, if the review was sourced from an external third-party.
-
1. `author_name`
2. `string`
3. The username of the author of the review.
-
1. `author_id`
2. `string`
3. The ID of the author of the review.
-
1. `syndication_source`
2. `string`
3. The syndication source for this review, if the review is syndicated.
-
1. `verified_purchase`
2. `boolean`
3. Whether this reviewer is an verified purchaser of the product. |
| `summary` | `object` | An object containing a summary of all reviews for the product, as shown at the top-left of the Customer Reviews page.
* `rating`
* `number`
* The overall rating of the product, out of 5.
* `ratings_total`
* `number`
* The total number of customer ratings the product has received.
* `recommended_percentage`
* `number`
* The percentage of reviews that recommend the product.
* `rating_breakdown`
* `object`
* **Rating Breakdown Object**
Contains details how many of each star rating value the product has received.
-
1. `one_star`
2. `number`
3. The number of one-star ratings received.
-
1. `two_star`
2. `number`
3. The number of two-star ratings received.
-
1. `three_star`
2. `number`
3. The number of three-star ratings received.
-
1. `four_star`
2. `number`
3. The number of four-star ratings received.
-
1. `five_star`
2. `number`
3. The number of five-star ratings received. |
| `pagination` | `object` | **Pagination Object
**
An object containing details of the current search results page and the total number of pages that are available. To paginate you should specify the page number in your request's `page` [parameter ](https://docs.trajectdata.com/redcircleapi/target-product-data-api/parameters/search).
* `current_page`
* `number`
* The current page number.
* `next_page`
* `number`
* The next page number, if a next page of results is available.
* `total_pages`
* `number`
* The total number of pages of results. |
***
**Next Steps**
[Reviews Parameters](https://docs.trajectdata.com/redcircleapi/target-product-data-api/parameters/reviews)