Reviews

2min

Reviews Results
When making a request with the  type  parameter 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 for a single product on Target.
Customer Reviews Page
﻿
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
  }
}
{
  "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.
﻿
is_external_source
boolean
True/false whether the review was sourced from an external third-party.
﻿
external_source
string
The name of the external third-party, if the review was sourced from an external third-party.
﻿
author_name
string
The username of the author of the review.
﻿
author_id
string
The ID of the author of the review.
﻿
syndication_source
string
The syndication source for this review, if the review is syndicated.
﻿
verified_purchase
boolean
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.
﻿
one_star
number
The number of one-star ratings received.
﻿
two_star
number
The number of two-star ratings received.
﻿
three_star
number
The number of three-star ratings received.
﻿
four_star
number
The number of four-star ratings received.
﻿
five_star
number
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 .
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﻿

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. is_external_source boolean True/false whether the review was sourced from an external third-party. external_source string The name of the external third-party, if the review was sourced from an external third-party. author_name string The username of the author of the review. author_id string The ID of the author of the review. syndication_source string The syndication source for this review, if the review is syndicated. verified_purchase boolean 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. one_star number The number of one-star ratings received. two_star number The number of two-star ratings received. three_star number The number of three-star ratings received. four_star number The number of four-star ratings received. five_star number 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 . 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.

Updated 06 Aug 2024

Did this page help you?

Product

Store Stock