Product

2 min

Product Results

When making a request with the type parameter set to type=product RedCircle API will return product details for the product specified in either the tcin , dpci or url parameter

Product details are retrieved from the product page for a single product on Target.

Target Product Page

An example of the JSON object returned from an Product request is shown below:

{
    "request_info":
    {
        "success": true,
        "credits_used": 1,
        "credits_remaining": 999
    },
    "request_metadata":
    {
        "created_at": "2020-01-01T00:00:00.000Z",
        "processed_at": "2020-01-01T00:00:00.001Z",
        "total_time_taken": 0.1,
        "target_url": "https://www.target.com/p/-/A-78025470"
    },
    "request_parameters":
    {
        "type": "product",
        "tcin": "78025470"
    },
    "product":
    {
        "tcin": "78025470",
        "title": "Sharpie Pocket 4pk Highlighters Narrow Chisel Tip Multicolored",
        "link": "https://www.target.com/p/sharpie-pocket-4pk-highlighters-narrow-chisel-tip-multicolored/-/A-78025470",
        "brand": "Sharpie",
        "brand_link": "https://www.target.com/b/sharpie/-/N-56cak",
        "upc": "071641174603",
        "dpci": "081-02-3451",
        "rating": 4.7,
        "ratings_total": 233,
        "ingredients": "PURIFIED WATER, MAGNESIUM SULFATE, POTASSIUM CHLORIDE, SALT.*+ *ADDS A NEGLIGIBLE AMOUNT OF SODIUM, +MINERALS ADDED FOR TASTE",
        "servings": 24,
        "nutrients":
        [
            {
                "name": "Calories",
                "quantity": 0,
                "unit": "Cal"
            },
            {
                "name": "Total Fat",
                "quantity": 0,
                "unit": "g"
            },
            {
                "name": "Sodium",
                "quantity": 0,
                "unit": "mg"
            },
            {
                "name": "Total Carbohydrate",
                "quantity": 0,
                "unit": "g"
            },
            {
                "name": "Protein",
                "quantity": 0,
                "unit": "g"
            }
        ],
        "main_image":
        {
            "link": "https://target.scene7.com/is/image/Target/GUEST_dd2740a1-b9a7-4a4f-906d-3244ff2b517e"
        },
        "images":
        [
            {
                "link": "https://target.scene7.com/is/image/Target/GUEST_dd2740a1-b9a7-4a4f-906d-3244ff2b517e"
            },
            {
                "link": "https://target.scene7.com/is/image/Target/GUEST_29507d0a-f7ee-483e-b6c1-72237ea26e7a"
            },
            {
                "link": "https://target.scene7.com/is/image/Target/GUEST_a6980245-9cab-435d-8469-4f01064e04b8"
            },
            {
                "link": "https://target.scene7.com/is/image/Target/GUEST_3680fd7d-ecec-40a9-a13d-7722546532ca"
            }
        ],
        "videos":
        [
            {
                "link": "https://target.scene7.com/is/content/Target/GUEST_75fa3d67-3821-4e47-8ddf-14aa56078d75_Flash9_Autox720p_2600k",
                "type": "video/mp4"
            },
            {
                "link": "https://target.scene7.com/is/content/Target/GUEST_0bf20858-cdf8-4e8a-bdc6-723433b97c61_Flash9_Autox720p_2600k",
                "type": "video/mp4"
            }
        ],
        "specifications":
        [
            {
                "name": "Dimensions (Overall)",
                "value": "4.0 Inches (H) x 2.5 Inches (W) x 2.75 Inches (D)"
            },
            {
                "name": "Weight",
                "value": ".25 ounces"
            },
            {
                "name": "Mount Type",
                "value": "Vent Mount"
            },
            {
                "name": "Material",
                "value": "Plastic"
            },
            {
                "name": "Warranty",
                "value": "1 Year Limited Warranty. To obtain a copy of the manufacturer's or supplier's warranty for this item prior to purchasing the item, please call Target Guest Services at 1-800-591-3869"
            }
        ],
        "specifications_flat": "Warranty: 1 Year Limited Warranty. To obtain a copy of the manufacturer's or supplier's warranty for this item prior to purchasing the item, please call Target Guest Services at 1-800-591-3869. Material: Plastic. Mount Type: Vent Mount. Weight: .25 ounces. Dimensions (Overall): 4.0 Inches (H) x 2.5 Inches (W) x 2.75 Inches (D).",
        "description": "Draw attention to important information in notes, text and documents with Sharpie Accent Highlighters. The 4 bright fluorescent colors make it easy to read highlighted text and emphasize important passages. Sharpie highlighters dry quickly and resist smearing of many pen and marker inks (let ink dry before highlighting). Includes pink, yellow, orange and blue highlighters. ",
        "feature_bullets":
        [
            "Bright, easy-to-see colors make your highlighted text easy to read",
            "Resists smearing of many pen and marker inks (let ink dry before highlighting)",
            "Easy-glide, narrow chisel tip is great for highlighting, underlining or writing notes",
            "Slim shape is easy to control and slips into backpacks or notebooks",
            "Includes: Fluorescent Pink, Yellow, Orange and Blue highlighters"
        ],
        "aisle": "C76",
        "weight": "0.14 pound",
        "dimensions": "0.71 inch (H) x 3.73 inch (W) x 7.61 inch (D)",
        "buybox_winner":
        {
            "price":
            {
                "value": 2.89,
                "currency_symbol": "$",
                "currency": "USD"
            },
            "maximum_order_quantity":
            {
                "pickup":
                {
                    "value": 6,
                    "hard_maximum": true
                },
                "delivery":
                {
                    "value": 6,
                    "hard_maximum": true
                },
                "shipping":
                {
                    "value": 6,
                    "hard_maximum": true
                }
            },
            "protection_plans":
            [
                {
                    "name": "3 Year TV Protection Plan - Allstate",
                    "duration_months": 36,
                    "price":
                    {
                        "billing_type": "one_time",
                        "value": 50,
                        "currency": "USD"
                    },
                    "additional_plan_details":
                    {
                        "benefits":
                        [
                            "Free 2-Way Shipping",
                            "24/7 Support",
                            "No Deductible",
                            "No Additional Cost"
                        ],
                        "support":
                        [
                            "Online",
                            "Phone"
                        ],
                        "includes":
                        [
                            "Mechanical Defects",
                            "Normal Wear and Tear Coverage"
                        ],
                        "minimum_qualifying_item_price":
                        {
                            "value": 250,
                            "currency": "USD"
                        },
                        "maximum_qualifying_item_price":
                        {
                            "value": 299.99,
                            "currency": "USD"
                        },
                        "service_plan_type": "Allstate - TV",
                        "number_of_years_protected": "3 years"
                    }
                }
            ],
            "availability":
            {
                "raw": "IN_STOCK",
                "in_stock": true
            },
            "fulfillment":
            {
                "type": "1p",
                "pickup": true,
                "pickup_info":
                {
                    "ready_in_minutes": 120,
                    "stock_level": 8,
                    "store_id": "1544",
                    "store_name": "Stamford",
                    "store_address": "21 Broad St",
                    "store_city": "Stamford",
                    "store_state": "Connecticut",
                    "store_zipcode": "06901-2309",
                    "store_timezone": "America/New_York"
                },
                "return_policy":
                {
                    "duration_days": 90,
                    "type": "Day",
                    "seller": "Target.com"
                },
                "delivery_from_store": true,
                "shipping": true,
                "shipping_info":
                {
                    "stock_level": 20,
                    "services":
                    [
                        {
                            "name": "Standard",
                            "description": "2-day shipping",
                            "is_default": true,
                            "cutoff_time": "2022-04-25T16:00:00Z",
                            "delivery_date": "2022-04-27"
                        }
                    ]
                }
            }
        },
        "variants":
        [
            {
                "tcin": "80944742",
                "dpci": "249-05-0062",
                "upc": "191908446738",
                "title": "Futon Sofa with Arms Charcoal Gray - Room Essentials",
                "link": "https://www.target.com/p/futon-sofa-with-arms-charcoal-gray-room-essentials-8482/-/A-80944742",
                "main_image": "https://target.scene7.com/is/image/Target/GUEST_75355849-d52d-4d67-ab5e-c53555509118",
                "swatch_image": "https://target.scene7.com/is/image/Target/GUEST_ba8394de-9ca0-42d6-8786-e61980a930db",
                "price":
                {
                    "value": 240,
                    "currency_symbol": "$",
                    "currency": "USD"
                }
            },
            {
                "tcin": "53214563",
                "dpci": "249-05-0199",
                "upc": "672975504878",
                "title": "Futon Sofa With Arms Light Gray - Room Essentials",
                "link": "https://www.target.com/p/futon-sofa-with-arms-light-gray-room-essentials-8482/-/A-53214563",
                "main_image": "https://target.scene7.com/is/image/Target/GUEST_36d5db84-693e-4593-9694-710bae4f2263",
                "swatch_image": "https://target.scene7.com/is/image/Target/GUEST_fc5ac11c-d07a-4816-b66d-e0e6cb9f98a0",
                "price":
                {
                    "value": 340,
                    "currency_symbol": "$",
                    "currency": "USD"
                }
            }
        ],
        "top_reviews":
        [
            {
                "position": 1,
                "id": "6cc7ed6a-e56d-43e5-b5c2-b4277b336134",
                "title": "Delicious!",
                "body": "This espresso is delicious! I have used Nespresso�s Single Origin capsules for years because of their taste and quality, and thought I�d give this a try since it was quite a bit cheaper. I�m going to switch to this as my go-to Espresso! I hope Target adds more to their Single Origin lineup!",
                "date": "2022-03-22T17:08:46.416Z",
                "rating": 5,
                "source":
                {
                    "is_external_source": false,
                    "author_name": "Avery",
                    "author_id": "1999777574",
                    "verified_purchase": false
                }
            },
            {
                "position": 2,
                "id": "eb2abd4b-e9fe-4f64-b211-0d8731bf969b",
                "title": "Delicious and affordable!",
                "body": "These were the first store brand Nespresso capsules I�ve ever tried. I was very hesitant. They�re so delicious!",
                "date": "2022-02-24T03:51:20.194Z",
                "rating": 5,
                "source":
                {
                    "is_external_source": false,
                    "author_name": "Nico",
                    "author_id": "2629062174",
                    "verified_purchase": false
                }
            }
        ]
    },
    "location_info":
    {
        "address": "919 Highway D",
        "city": "Osage Beach",
        "state": "Missouri",
        "zipcode": "65065-3169",
        "store_name": "Osage Beach",
        "store_id": "1914"
    }
}

RedCircle API returns the following properties for Product requests:

Property	Type	Description
product	object	An object containing details of the primary product shown on the product page. title string The product title. link string The URL to the product page. brand string The brand name of the product, if shown. brand_link string A URL to the brand landing page. tcin string The product TCIN (Target product ID). Pass the tcin into a type=product request to get product-level data about the product. dpci string The Target "Department - Class - Item" ID of the product. upc string The UPC of the product, if shown. description string The main descriptive text of the product shown on the product page. aisle string The product in-store aisle location (if available). You can determine which store the results are taken from using the customer_zipcode request parameter. ingredients string The ingredients string (for grocery TCINs). servings number The ingredients string (for grocery TCINs). nutrients array Nutrients Array The main image object contains primary image shown when the product page was loaded. name string The name of the nutrient. quantity number The quantity of the nutrient. unit string The unit the nutrient quantity is measured in. feature_bullets array The feature bullets property contains an array of strings representing the bullet-point features shown on the product page. main_image object Main Image Object The main image object contains primary image shown when the product page was loaded. link string A link to the main image. images array Images Array The images property contains an array of image objects containing the other available product images, excluding the main image. The image object has the following properties: link string A link to the image. videos array Videos Array The videos property contains an array of video objects. The video object has the following properties: link string A link to the video. type string The MIME type (i.e. video/mp4 ) of the video. breadcrumbs array Breadcrumbs Array An array containing details of the category breadcrumbs in the title section the page (if shown). Each object in the breadcrumbs array contains the following properties: name string The name of the category breadcrumb. link string A link to the category breadcrumb. specifications array Specifications Array The specifications array contains details of the product specifications as shown in the specifications tables. name string The name of the specification i.e. "Batteries". value string The value of the specification i.e. "2 AA Batteries". specifications_flat string The specifications flat property contains the contents of the specifications array flattened into a string. This is useful when exporting data as CSV when you require all the specifications content in one field rather than split across multiple rows. variants array Variants Array The variants array contains details of variants of the current product as shown on the product page. tcin string The TCIN of the variant product. Can be passed in to a subsequent type=product request in the tcin parameter to retrieve product details of the variant. dpci string The DPCI of the variant product. upc string The UPC of the variant product, if shown. link string The link to the product page of the variant product. title string The title of the variant product. main_image string The image URL to the main image of the variant product. swatch_image string The swatch image URL to the main image of the variant product. attributes object An object representing the attributes of the variant. Eg Size , Color , etc price object An object representing the price of the variant product. rating number The overall rating of the product, out of 5. ratings_total number The total number of customer ratings the product has received. weight string The product weight, if shown. dimensions string The product dimensions (if available). top_reviews array An array of review objects containing the reviews shown on the product page under the "Guest Ratings & Reviews" heading. The review object has a subset of the properties returned by a type=reviews reviews request . Note to return all reviews for a given product use the reviews request . buybox_winner object Buybox Winner Object The "buybox" describes the winning offer for the product. The buybox_winner object contains details of the winning offer and has the following properties: Price Object The price object represents the price of the buybox winning offer. It has the following properties: value number The price of the buybox winning offer. currency string The 3-letter ISO currency code of the buybox winning offer - i.e. USD . currency_symbol string The currency symbol of the buybox winning offer - i.e. $ . Was Price Object The was price object represents the was (previous) price of the buybox winning offer, if shown. It has the following properties: value number The was price of the buybox winning offer. currency string The 3-letter ISO currency code of the buybox winning offer - i.e. USD . currency_symbol string The currency symbol of the buybox winning offer - i.e. $ . Availability Object The availability object contains details the buybox-winning product availability. It has the following properties: raw string The raw availability text as shown on the product page. in_stock boolean Set to true if the product is in stock via any fulfillment channel, false otherwise. Protection Plans A list of available protection plans for the product, if offered: name string The name of the protection plan duration_months integer length of coverage in months price object price details of the plan additional_plan_details object Nested object with benefit, coverage, and qualification info Maximum Order Quantity Specifies the maximum quantity a customer can order per fulfillment method. Each order object contains the numeric limit: value, and hard_maximum: true/false boolean. pickup object maximum quantity allowed for pickup delivery object maximum quantity allowed for delivery shipping object maximum quantity allowed for shipping Return Policy Object Specifies the product’s return eligibility and conditions as provided by the seller.. duration number The number of calendar days the item can be returned (e.g., 90). type string The unit of time (typically "Day"), indicating return window length. seller string The name of the seller responsible for processing returns (e.g., "Target.com"). Seller Object The seller object contains details the seller of the buybox-winning offer. It has the following properties: name string The name of the seller of the buybox winning offer. id string The ID of the seller of the buybox winning offer. link string A link to the sellers landing page on the Target website. Fulfillment Object The fulfillment object contains details the fulfillment channels for the buybox-winning product offer. It has the following properties: type string The fulfillment model for the offer, values are be: 1p sold and fulfilled by Target. 3p sold and fulfilled by third party seller. pickup boolean Set to true if the pickup-from-store fulfillment channel is available ( pickup_info will be present with further details), false otherwise. pickup_info object Populated when pickup=true . Contains a ready_in_minutes property giving the number of minutes the in-store pickup will be available, stock_level indicating the quantity available in-store and further properties detailing the store address. delivery_from_store boolean Set to true if the delivery-from-store fulfillment channel (typically Shipt) is available, false otherwise. shipping boolean Set to true if the shipping fulfillment channel is available ( shipping_info will be present with further details), false otherwise. shipping_info object Populated when shipping=true . Contains a stock_level indicating the quantity available for shipping and a services array containing details of each of the types of shipping service offered. Note that the shipping service with is_default=true set is the default selected shipping service for the product.
location_info	object	Location Info Object An object containing details of the location in which the request was run, as-per the customer_zipcode request parameter. Only present when the product.buybox_winner.fulfillment.pickup=true (i.e. when the product is available in-store). address string The address of the store the request was run in. city string The city the request was run in. state string The state the request was run in. zipcode string The zipcode the request was run in. store_name string The name of the store that the request was run from. store_id string The ID of the store that the request was run from.

Next Steps Product Parameters