Search

2min

Search Results
When making a request with the  type  parameter set to  type=search  RedCircle API will return search results from Target.
Search results are retrieved from the search results page on Target.
Search Results Page
﻿
An example of the JSON object returned from a Search request is shown below:
JSON
{
  "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.000Z",
    "total_time_taken": 2.15,
    "target_url": "https://www.target.com/s?searchTerm=highlighter+pens&sortBy=bestselling&Nao=0&facetedValue=5zja3Zfwtfr"
  },
  "request_parameters": {
    "type": "search",
    "search_term": "highlighter pens",
    "sort_by": "best_seller"
  },
  "search_results": [
    {
      "position": 1,
      "product": {
        "title": "Sharpie 12pk Highlighters Clearview Chisel Tip Multicolor",
        "link": "https://www.target.com/p/sharpie-12pk-highlighters-clearview-chisel-tip-multicolor/-/A-54241380",
        "tcin": "54241380",
        "dpci": "081-02-2450",
        "sponsored": true,
        "class_id": 2,
        "department_id": 81,
        "brand": "Sharpie",
        "brand_link": "https://www.target.com/b/sharpie/-/N-56cak",
        "feature_bullets": [
          "Clear tip allows you to highlight neatly and evenly all the way across the page",
          "Slim barrel for optimal control, precise highlights and clear, legible notes",
          "Fine chisel end draws thicker lines for highlighting or thin lines for underlining",
          "Resists smearing of many pen and marker inks (let ink dry before highlighting)",
          "Includes 12 highlighters in assorted colors"
        ],
        "rating": 4.7,
        "ratings_total": 58,
        "main_image": "https://target.scene7.com/is/image/Target/GUEST_94e3b7f9-4008-4910-8f5e-1fffa0cd9ab0",
        "images": [
          "https://target.scene7.com/is/image/Target/GUEST_94e3b7f9-4008-4910-8f5e-1fffa0cd9ab0",
          "https://target.scene7.com/is/image/Target/GUEST_4c328408-6ddf-453a-8186-c3ad8b465dab",
          "https://target.scene7.com/is/image/Target/GUEST_db387ea7-5716-463b-abfd-5684e1bc1435",
          "https://target.scene7.com/is/image/Target/GUEST_b08515e9-db62-4d4f-8423-ce260de64e77"
        ],
        "videos": [
          {
            "link": "https://target.scene7.com/is/content/Target/GUEST_6a704552-1e1c-4841-b170-195add122580_Flash9_Autox720p_2600k",
            "type": "video/mp4"
          }
        ]
      },
      "offers": {
        "primary": {
          "price": 18.99,
          "currency": "USD",
          "symbol": "$"
        },
        "all_offers": [
          {
            "price": 18.99,
            "currency": "USD",
            "symbol": "$"
          }
        ]
      },
      "fulfillment": {
        "type": "3p"
      },
      "seller": {
        "name": "MyOfficeInnovations",
        "id": "10003960"
      }
    },
    {
      "position": 2,
      "product": {
        "title": "24pk Marker Pens Flair Medium Tip .7mm Multicolor - PaperMate",
        "link": "https://www.target.com/p/24pk-marker-pens-flair-medium-tip-7mm-multicolor-papermate/-/A-50358888",
        "tcin": "50358888",
        "dpci": "081-02-2035",
        "class_id": 2,
        "department_id": 81,
        "brand": "Paper Mate",
        "brand_link": "https://www.target.com/b/paper-mate/-/N-56c8g",
        "feature_bullets": [
          "Add a blast of fun to all your writing",
          "Medium Point felt tip for bold, expressive lines",
          "Smear-resistant ink for less smudging",
          "Water-based ink won't bleed through paper",
          "The point guard prevents the tip from fraying",
          "Packaging may vary"
        ],
        "rating": 4.5,
        "ratings_total": 89,
        "main_image": "https://target.scene7.com/is/image/Target/GUEST_0b42c2dc-18b4-4144-b3f4-d751b63a9b7f",
        "images": [
          "https://target.scene7.com/is/image/Target/GUEST_0b42c2dc-18b4-4144-b3f4-d751b63a9b7f",
          "https://target.scene7.com/is/image/Target/GUEST_d359e44b-88a6-452d-8f5b-d6cb649e3052",
          "https://target.scene7.com/is/image/Target/GUEST_cc9f2ecb-cb0b-408d-a2c7-0a4523f92cc6",
          "https://target.scene7.com/is/image/Target/GUEST_3271d3b6-0202-450d-b8b0-a49e9f4d3190",
          "https://target.scene7.com/is/image/Target/GUEST_4fcba98a-7ef8-4f65-8300-f0ec0de012a8",
          "https://target.scene7.com/is/image/Target/GUEST_94994d28-d988-4cfc-947e-7fdb89e6018a",
          "https://target.scene7.com/is/image/Target/GUEST_588a8aa2-ca69-4f78-aa03-3347ae5870cf"
        ],
        "videos": [
          {
            "link": "https://target.scene7.com/is/content/Target/GUEST_ed214196-b36a-4de0-964e-2b2ddd1bc451_Flash9_Autox720p_2600k",
            "type": "video/mp4"
          },
          {
            "link": "https://target.scene7.com/is/content/Target/GUEST_f2a05f63-8412-4ef7-86bf-2569752b320b_Flash9_Autox720p_2600k",
            "type": "video/mp4"
          }
        ]
      },
      "offers": {
        "primary": {
          "price": 19.99,
          "currency": "USD",
          "symbol": "$",
          "regular_price": 24.99
        },
        "all_offers": [
          {
            "price": 19.99,
            "currency": "USD",
            "symbol": "$",
            "regular_price": 24.99
          }
        ]
      },
      "fulfillment": {
        "type": "1p"
      }
    }
  ],
  "related_queries": [
    {
      "query": "dry erase marker",
      "link": "https://www.target.com/s?searchTerm=dry+erase+marker"
    },
    {
      "query": "green pen",
      "link": "https://www.target.com/s?searchTerm=green+pen"
    },
    {
      "query": "washable markers",
      "link": "https://www.target.com/s?searchTerm=washable+markers"
    },
    {
      "query": "crayola markers",
      "link": "https://www.target.com/s?searchTerm=crayola+markers"
    }
  ],
  "pagination": {
    "current": {
      "page": 1,
      "link": "https://www.target.com/s?searchTerm=highlighter+pens&sortBy=bestselling&Nao=0&facetedValue=5zja3Zfwtfr"
    },
    "next": {
      "page": 2,
      "link": "https://www.target.com/s?searchTerm=highlighter+pens&sortBy=bestselling&Nao=24&facetedValue=5zja3Zfwtfr"
    },
    "total_pages": 5,
    "total_results": 119
  },
  "categories": [
    {
      "name": "School & Office Supplies",
      "id": "5xsxr"
    },
    {
      "name": "Home",
      "id": "5xtvd"
    },
    {
      "name": "Toys",
      "id": "5xtb0"
    }
  ],
  "facets": [
    {
      "display_name": "Price",
      "name": "d_pricerange",
      "values": [
        {
          "display_name": "$0 - $15",
          "value": "$0 - $15",
          "id": "5zja2"
        },
        {
          "display_name": "$15 - $25",
          "value": "$15 - $25",
          "id": "5zja3"
        },
        {
          "display_name": "$25 - $50",
          "value": "$25 - $50",
          "id": "5zja4"
        },
        {
          "display_name": "$50 - $100",
          "value": "$50 - $100",
          "id": "5zja5"
        },
        {
          "display_name": "$100 - $150",
          "value": "$100 - $150",
          "id": "5zja6"
        },
        {
          "display_name": "$150 - $200",
          "value": "$150 - $200",
          "id": "5zja7"
        },
        {
          "display_name": "$500 - $800",
          "value": "$500 - $800",
          "id": "5zjaa"
        }
      ]
    },
    {
      "display_name": "Sold by",
      "name": "d_sellers_all",
      "values": [
        {
          "display_name": "Target",
          "value": "target",
          "id": "dq4mn"
        },
        {
          "display_name": "Arteza",
          "value": "arteza",
          "id": "zbi86"
        },
        {
          "display_name": "MyOfficeInnovations",
          "value": "myofficeinnovations",
          "id": "jp8ap"
        },
        {
          "display_name": "School Specialty",
          "value": "school specialty",
          "id": "7gkvi"
        }
      ]
    },
    {
      "display_name": "Shipping & Pickup",
      "name": "d_channel",
      "values": [
        {
          "display_name": "buy online & pick up",
          "value": "buy online & pick up",
          "id": "5zl7w"
        },
        {
          "display_name": "in stores",
          "value": "in stores",
          "id": "5zkty"
        },
        {
          "display_name": "shipping",
          "value": "shipping",
          "id": "5zktx"
        },
        {
          "display_name": "include out of stock",
          "value": "include out of stock",
          "id": "fwtfr"
        },
        {
          "display_name": "same day delivery",
          "value": "same day delivery",
          "id": "cl92v"
        }
      ]
    },
    {
      "display_name": "Color",
      "name": "d_color_all",
      "values": [
        {
          "display_name": "Black",
          "value": "black",
          "id": "5y761"
        },
        {
          "display_name": "Blue",
          "value": "blue",
          "id": "5y70h"
        },
        {
          "display_name": "Brown",
          "value": "brown",
          "id": "5y746"
        },
        {
          "display_name": "Clear",
          "value": "clear",
          "id": "5y6nd"
        },
        {
          "display_name": "Gray",
          "value": "gray",
          "id": "5y759"
        },
        {
          "display_name": "Green",
          "value": "green",
          "id": "5y73r"
        },
        {
          "display_name": "Multicolored",
          "value": "multicolored",
          "id": "5xr7i"
        },
        {
          "display_name": "Orange",
          "value": "orange",
          "id": "55ivi"
        },
        {
          "display_name": "Pink",
          "value": "pink",
          "id": "5y76n"
        },
        {
          "display_name": "Purple",
          "value": "purple",
          "id": "5y6hb"
        },
        {
          "display_name": "Red",
          "value": "red",
          "id": "5y76d"
        },
        {
          "display_name": "Yellow",
          "value": "yellow",
          "id": "5y72c"
        }
      ]
    },
    {
      "display_name": "Type",
      "name": "d_item_type_all",
      "values": [
        {
          "display_name": "Artist Markers",
          "value": "artist markers",
          "id": "cdkak"
        },
        {
          "display_name": "Brush Markers",
          "value": "brush markers",
          "id": "rdnzh"
        },
        {
          "display_name": "Dry Erase Markers",
          "value": "dry erase markers",
          "id": "jbq9g"
        },
        {
          "display_name": "Felt Tip Pens",
          "value": "felt tip pens",
          "id": "555of"
        },
        {
          "display_name": "Fountain Pens",
          "value": "fountain pens",
          "id": "551o6"
        },
        {
          "display_name": "Gel Pens",
          "value": "gel pens",
          "id": "xf87j"
        },
        {
          "display_name": "Highlighters",
          "value": "highlighters",
          "id": "6c0j"
        },
        {
          "display_name": "Permanent Markers",
          "value": "permanent markers",
          "id": "4nx9j"
        },
        {
          "display_name": "Rollerball Pens",
          "value": "rollerball pens",
          "id": "55o93"
        }
      ]
    },
    {
      "display_name": "Package Quantity",
      "name": "d_package_quantity",
      "values": [
        {
          "display_name": "0 - 10",
          "value": "0 - 10",
          "id": "xo6o1"
        },
        {
          "display_name": "11 - 20",
          "value": "11 - 20",
          "id": "51tyh"
        },
        {
          "display_name": "21 - 30",
          "value": "21 - 30",
          "id": "ted2d"
        },
        {
          "display_name": "31 - 40",
          "value": "31 - 40",
          "id": "9s9jm"
        },
        {
          "display_name": "41 - 50",
          "value": "41 - 50",
          "id": "1o5mp"
        },
        {
          "display_name": "51 - 60",
          "value": "51 - 60",
          "id": "zl11t"
        }
      ]
    },
    {
      "display_name": "Brand",
      "name": "d_brand_all",
      "values": [
        {
          "display_name": "Arteza",
          "value": "arteza",
          "id": "q643le9kydq"
        },
        {
          "display_name": "Avery",
          "value": "avery",
          "id": "5d7pg"
        },
        {
          "display_name": "BiC",
          "value": "bic",
          "id": "5pteu"
        },
        {
          "display_name": "Business Source",
          "value": "business source",
          "id": "n71bf"
        },
        {
          "display_name": "Faber-Castell",
          "value": "faber-castell",
          "id": "5s4to"
        },
        {
          "display_name": "Integra",
          "value": "integra",
          "id": "34h06"
        },
        {
          "display_name": "MyOfficeInnovations",
          "value": "myofficeinnovations",
          "id": "q643leoowt"
        },
        {
          "display_name": "Paper Mate",
          "value": "paper mate",
          "id": "56c8g"
        },
        {
          "display_name": "Pentel",
          "value": "pentel",
          "id": "5d7u4"
        },
        {
          "display_name": "Pilot",
          "value": "pilot",
          "id": "5d8yf"
        },
        {
          "display_name": "Sakura",
          "value": "sakura",
          "id": "if0po"
        },
        {
          "display_name": "School Smart",
          "value": "school smart",
          "id": "8q5wb"
        },
        {
          "display_name": "Sharpie",
          "value": "sharpie",
          "id": "56cak"
        },
        {
          "display_name": "Staedtler",
          "value": "staedtler",
          "id": "56i5t"
        },
        {
          "display_name": "Staples",
          "value": "staples",
          "id": "q643lev0bck"
        },
        {
          "display_name": "Tombow",
          "value": "tombow",
          "id": "54xlg"
        },
        {
          "display_name": "TRU RED",
          "value": "tru red",
          "id": "q643leviis7"
        },
        {
          "display_name": "Universal",
          "value": "universal",
          "id": "5wthz"
        },
        {
          "display_name": "Yoobi",
          "value": "yoobi",
          "id": "551o8"
        },
        {
          "display_name": "Zebra",
          "value": "zebra",
          "id": "5537i"
        }
      ]
    },
    {
      "display_name": "Deals",
      "name": "d_deals",
      "values": [
        {
          "display_name": "All Deals",
          "value": "all deals",
          "id": "akkos"
        },
        {
          "display_name": "Buy and Save",
          "value": "buy and save",
          "id": "55e6t"
        },
        {
          "display_name": "GiftCard with Purchase",
          "value": "giftcard with purchase",
          "id": "55e6u"
        },
        {
          "display_name": "Sale",
          "value": "sale",
          "id": "5tdv0"
        },
        {
          "display_name": "Weekly Ad",
          "value": "weekly ad",
          "id": "55dgn"
        }
      ]
    },
    {
      "display_name": "Lead Size",
      "name": "d_lead_size",
      "values": [
        {
          "display_name": "0.5mm",
          "value": "0.5mm",
          "id": "5pxtk9559ri"
        },
        {
          "display_name": "0.7mm",
          "value": "0.7mm",
          "id": "5pxtk9559rj"
        },
        {
          "display_name": "1.0mm",
          "value": "1.0mm",
          "id": "5pxtk95qrby"
        },
        {
          "display_name": "1.6mm",
          "value": "1.6mm",
          "id": "5pxtk9mlxhe"
        },
        {
          "display_name": "Extra Fine",
          "value": "extra fine",
          "id": "5pxtk92jhgy"
        },
        {
          "display_name": "Fine",
          "value": "fine",
          "id": "5pxtk9n6e8u"
        }
      ]
    },
    {
      "display_name": "Finish",
      "name": "d_finish_and_color",
      "values": [
        {
          "display_name": "Black",
          "value": "black",
          "id": "4o3k2"
        },
        {
          "display_name": "Yellow",
          "value": "yellow",
          "id": "4b21u25xkpk"
        },
        {
          "display_name": "Blue",
          "value": "blue",
          "id": "4b21u25xku0"
        },
        {
          "display_name": "Green",
          "value": "green",
          "id": "4b21u25xkwh"
        },
        {
          "display_name": "Orange",
          "value": "orange",
          "id": "4b21u255ivh"
        },
        {
          "display_name": "Pink",
          "value": "pink",
          "id": "4b21u25xkwk"
        },
        {
          "display_name": "Purple",
          "value": "purple",
          "id": "4b21u25xkug"
        }
      ]
    },
    {
      "display_name": "FPO/APO",
      "name": "d_apo_fpo",
      "values": [
        {
          "display_name": "only eligible items",
          "value": "only eligible items",
          "id": "vu13f"
        }
      ]
    },
    {
      "display_name": "Featured",
      "name": "d_marketing",
      "values": [
        {
          "display_name": "New",
          "value": "new",
          "id": "5ewil"
        }
      ]
    }
  ]
}
{
  "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.000Z",
    "total_time_taken": 2.15,
    "target_url": "https://www.target.com/s?searchTerm=highlighter+pens&sortBy=bestselling&Nao=0&facetedValue=5zja3Zfwtfr"
  },
  "request_parameters": {
    "type": "search",
    "search_term": "highlighter pens",
    "sort_by": "best_seller"
  },
  "search_results": [
    {
      "position": 1,
      "product": {
        "title": "Sharpie 12pk Highlighters Clearview Chisel Tip Multicolor",
        "link": "https://www.target.com/p/sharpie-12pk-highlighters-clearview-chisel-tip-multicolor/-/A-54241380",
        "tcin": "54241380",
        "dpci": "081-02-2450",
        "sponsored": true,
        "class_id": 2,
        "department_id": 81,
        "brand": "Sharpie",
        "brand_link": "https://www.target.com/b/sharpie/-/N-56cak",
        "feature_bullets": [
          "Clear tip allows you to highlight neatly and evenly all the way across the page",
          "Slim barrel for optimal control, precise highlights and clear, legible notes",
          "Fine chisel end draws thicker lines for highlighting or thin lines for underlining",
          "Resists smearing of many pen and marker inks (let ink dry before highlighting)",
          "Includes 12 highlighters in assorted colors"
        ],
        "rating": 4.7,
        "ratings_total": 58,
        "main_image": "https://target.scene7.com/is/image/Target/GUEST_94e3b7f9-4008-4910-8f5e-1fffa0cd9ab0",
        "images": [
          "https://target.scene7.com/is/image/Target/GUEST_94e3b7f9-4008-4910-8f5e-1fffa0cd9ab0",
          "https://target.scene7.com/is/image/Target/GUEST_4c328408-6ddf-453a-8186-c3ad8b465dab",
          "https://target.scene7.com/is/image/Target/GUEST_db387ea7-5716-463b-abfd-5684e1bc1435",
          "https://target.scene7.com/is/image/Target/GUEST_b08515e9-db62-4d4f-8423-ce260de64e77"
        ],
        "videos": [
          {
            "link": "https://target.scene7.com/is/content/Target/GUEST_6a704552-1e1c-4841-b170-195add122580_Flash9_Autox720p_2600k",
            "type": "video/mp4"
          }
        ]
      },
      "offers": {
        "primary": {
          "price": 18.99,
          "currency": "USD",
          "symbol": "$"
        },
        "all_offers": [
          {
            "price": 18.99,
            "currency": "USD",
            "symbol": "$"
          }
        ]
      },
      "fulfillment": {
        "type": "3p"
      },
      "seller": {
        "name": "MyOfficeInnovations",
        "id": "10003960"
      }
    },
    {
      "position": 2,
      "product": {
        "title": "24pk Marker Pens Flair Medium Tip .7mm Multicolor - PaperMate",
        "link": "https://www.target.com/p/24pk-marker-pens-flair-medium-tip-7mm-multicolor-papermate/-/A-50358888",
        "tcin": "50358888",
        "dpci": "081-02-2035",
        "class_id": 2,
        "department_id": 81,
        "brand": "Paper Mate",
        "brand_link": "https://www.target.com/b/paper-mate/-/N-56c8g",
        "feature_bullets": [
          "Add a blast of fun to all your writing",
          "Medium Point felt tip for bold, expressive lines",
          "Smear-resistant ink for less smudging",
          "Water-based ink won't bleed through paper",
          "The point guard prevents the tip from fraying",
          "Packaging may vary"
        ],
        "rating": 4.5,
        "ratings_total": 89,
        "main_image": "https://target.scene7.com/is/image/Target/GUEST_0b42c2dc-18b4-4144-b3f4-d751b63a9b7f",
        "images": [
          "https://target.scene7.com/is/image/Target/GUEST_0b42c2dc-18b4-4144-b3f4-d751b63a9b7f",
          "https://target.scene7.com/is/image/Target/GUEST_d359e44b-88a6-452d-8f5b-d6cb649e3052",
          "https://target.scene7.com/is/image/Target/GUEST_cc9f2ecb-cb0b-408d-a2c7-0a4523f92cc6",
          "https://target.scene7.com/is/image/Target/GUEST_3271d3b6-0202-450d-b8b0-a49e9f4d3190",
          "https://target.scene7.com/is/image/Target/GUEST_4fcba98a-7ef8-4f65-8300-f0ec0de012a8",
          "https://target.scene7.com/is/image/Target/GUEST_94994d28-d988-4cfc-947e-7fdb89e6018a",
          "https://target.scene7.com/is/image/Target/GUEST_588a8aa2-ca69-4f78-aa03-3347ae5870cf"
        ],
        "videos": [
          {
            "link": "https://target.scene7.com/is/content/Target/GUEST_ed214196-b36a-4de0-964e-2b2ddd1bc451_Flash9_Autox720p_2600k",
            "type": "video/mp4"
          },
          {
            "link": "https://target.scene7.com/is/content/Target/GUEST_f2a05f63-8412-4ef7-86bf-2569752b320b_Flash9_Autox720p_2600k",
            "type": "video/mp4"
          }
        ]
      },
      "offers": {
        "primary": {
          "price": 19.99,
          "currency": "USD",
          "symbol": "$",
          "regular_price": 24.99
        },
        "all_offers": [
          {
            "price": 19.99,
            "currency": "USD",
            "symbol": "$",
            "regular_price": 24.99
          }
        ]
      },
      "fulfillment": {
        "type": "1p"
      }
    }
  ],
  "related_queries": [
    {
      "query": "dry erase marker",
      "link": "https://www.target.com/s?searchTerm=dry+erase+marker"
    },
    {
      "query": "green pen",
      "link": "https://www.target.com/s?searchTerm=green+pen"
    },
    {
      "query": "washable markers",
      "link": "https://www.target.com/s?searchTerm=washable+markers"
    },
    {
      "query": "crayola markers",
      "link": "https://www.target.com/s?searchTerm=crayola+markers"
    }
  ],
  "pagination": {
    "current": {
      "page": 1,
      "link": "https://www.target.com/s?searchTerm=highlighter+pens&sortBy=bestselling&Nao=0&facetedValue=5zja3Zfwtfr"
    },
    "next": {
      "page": 2,
      "link": "https://www.target.com/s?searchTerm=highlighter+pens&sortBy=bestselling&Nao=24&facetedValue=5zja3Zfwtfr"
    },
    "total_pages": 5,
    "total_results": 119
  },
  "categories": [
    {
      "name": "School & Office Supplies",
      "id": "5xsxr"
    },
    {
      "name": "Home",
      "id": "5xtvd"
    },
    {
      "name": "Toys",
      "id": "5xtb0"
    }
  ],
  "facets": [
    {
      "display_name": "Price",
      "name": "d_pricerange",
      "values": [
        {
          "display_name": "$0 - $15",
          "value": "$0 - $15",
          "id": "5zja2"
        },
        {
          "display_name": "$15 - $25",
          "value": "$15 - $25",
          "id": "5zja3"
        },
        {
          "display_name": "$25 - $50",
          "value": "$25 - $50",
          "id": "5zja4"
        },
        {
          "display_name": "$50 - $100",
          "value": "$50 - $100",
          "id": "5zja5"
        },
        {
          "display_name": "$100 - $150",
          "value": "$100 - $150",
          "id": "5zja6"
        },
        {
          "display_name": "$150 - $200",
          "value": "$150 - $200",
          "id": "5zja7"
        },
        {
          "display_name": "$500 - $800",
          "value": "$500 - $800",
          "id": "5zjaa"
        }
      ]
    },
    {
      "display_name": "Sold by",
      "name": "d_sellers_all",
      "values": [
        {
          "display_name": "Target",
          "value": "target",
          "id": "dq4mn"
        },
        {
          "display_name": "Arteza",
          "value": "arteza",
          "id": "zbi86"
        },
        {
          "display_name": "MyOfficeInnovations",
          "value": "myofficeinnovations",
          "id": "jp8ap"
        },
        {
          "display_name": "School Specialty",
          "value": "school specialty",
          "id": "7gkvi"
        }
      ]
    },
    {
      "display_name": "Shipping & Pickup",
      "name": "d_channel",
      "values": [
        {
          "display_name": "buy online & pick up",
          "value": "buy online & pick up",
          "id": "5zl7w"
        },
        {
          "display_name": "in stores",
          "value": "in stores",
          "id": "5zkty"
        },
        {
          "display_name": "shipping",
          "value": "shipping",
          "id": "5zktx"
        },
        {
          "display_name": "include out of stock",
          "value": "include out of stock",
          "id": "fwtfr"
        },
        {
          "display_name": "same day delivery",
          "value": "same day delivery",
          "id": "cl92v"
        }
      ]
    },
    {
      "display_name": "Color",
      "name": "d_color_all",
      "values": [
        {
          "display_name": "Black",
          "value": "black",
          "id": "5y761"
        },
        {
          "display_name": "Blue",
          "value": "blue",
          "id": "5y70h"
        },
        {
          "display_name": "Brown",
          "value": "brown",
          "id": "5y746"
        },
        {
          "display_name": "Clear",
          "value": "clear",
          "id": "5y6nd"
        },
        {
          "display_name": "Gray",
          "value": "gray",
          "id": "5y759"
        },
        {
          "display_name": "Green",
          "value": "green",
          "id": "5y73r"
        },
        {
          "display_name": "Multicolored",
          "value": "multicolored",
          "id": "5xr7i"
        },
        {
          "display_name": "Orange",
          "value": "orange",
          "id": "55ivi"
        },
        {
          "display_name": "Pink",
          "value": "pink",
          "id": "5y76n"
        },
        {
          "display_name": "Purple",
          "value": "purple",
          "id": "5y6hb"
        },
        {
          "display_name": "Red",
          "value": "red",
          "id": "5y76d"
        },
        {
          "display_name": "Yellow",
          "value": "yellow",
          "id": "5y72c"
        }
      ]
    },
    {
      "display_name": "Type",
      "name": "d_item_type_all",
      "values": [
        {
          "display_name": "Artist Markers",
          "value": "artist markers",
          "id": "cdkak"
        },
        {
          "display_name": "Brush Markers",
          "value": "brush markers",
          "id": "rdnzh"
        },
        {
          "display_name": "Dry Erase Markers",
          "value": "dry erase markers",
          "id": "jbq9g"
        },
        {
          "display_name": "Felt Tip Pens",
          "value": "felt tip pens",
          "id": "555of"
        },
        {
          "display_name": "Fountain Pens",
          "value": "fountain pens",
          "id": "551o6"
        },
        {
          "display_name": "Gel Pens",
          "value": "gel pens",
          "id": "xf87j"
        },
        {
          "display_name": "Highlighters",
          "value": "highlighters",
          "id": "6c0j"
        },
        {
          "display_name": "Permanent Markers",
          "value": "permanent markers",
          "id": "4nx9j"
        },
        {
          "display_name": "Rollerball Pens",
          "value": "rollerball pens",
          "id": "55o93"
        }
      ]
    },
    {
      "display_name": "Package Quantity",
      "name": "d_package_quantity",
      "values": [
        {
          "display_name": "0 - 10",
          "value": "0 - 10",
          "id": "xo6o1"
        },
        {
          "display_name": "11 - 20",
          "value": "11 - 20",
          "id": "51tyh"
        },
        {
          "display_name": "21 - 30",
          "value": "21 - 30",
          "id": "ted2d"
        },
        {
          "display_name": "31 - 40",
          "value": "31 - 40",
          "id": "9s9jm"
        },
        {
          "display_name": "41 - 50",
          "value": "41 - 50",
          "id": "1o5mp"
        },
        {
          "display_name": "51 - 60",
          "value": "51 - 60",
          "id": "zl11t"
        }
      ]
    },
    {
      "display_name": "Brand",
      "name": "d_brand_all",
      "values": [
        {
          "display_name": "Arteza",
          "value": "arteza",
          "id": "q643le9kydq"
        },
        {
          "display_name": "Avery",
          "value": "avery",
          "id": "5d7pg"
        },
        {
          "display_name": "BiC",
          "value": "bic",
          "id": "5pteu"
        },
        {
          "display_name": "Business Source",
          "value": "business source",
          "id": "n71bf"
        },
        {
          "display_name": "Faber-Castell",
          "value": "faber-castell",
          "id": "5s4to"
        },
        {
          "display_name": "Integra",
          "value": "integra",
          "id": "34h06"
        },
        {
          "display_name": "MyOfficeInnovations",
          "value": "myofficeinnovations",
          "id": "q643leoowt"
        },
        {
          "display_name": "Paper Mate",
          "value": "paper mate",
          "id": "56c8g"
        },
        {
          "display_name": "Pentel",
          "value": "pentel",
          "id": "5d7u4"
        },
        {
          "display_name": "Pilot",
          "value": "pilot",
          "id": "5d8yf"
        },
        {
          "display_name": "Sakura",
          "value": "sakura",
          "id": "if0po"
        },
        {
          "display_name": "School Smart",
          "value": "school smart",
          "id": "8q5wb"
        },
        {
          "display_name": "Sharpie",
          "value": "sharpie",
          "id": "56cak"
        },
        {
          "display_name": "Staedtler",
          "value": "staedtler",
          "id": "56i5t"
        },
        {
          "display_name": "Staples",
          "value": "staples",
          "id": "q643lev0bck"
        },
        {
          "display_name": "Tombow",
          "value": "tombow",
          "id": "54xlg"
        },
        {
          "display_name": "TRU RED",
          "value": "tru red",
          "id": "q643leviis7"
        },
        {
          "display_name": "Universal",
          "value": "universal",
          "id": "5wthz"
        },
        {
          "display_name": "Yoobi",
          "value": "yoobi",
          "id": "551o8"
        },
        {
          "display_name": "Zebra",
          "value": "zebra",
          "id": "5537i"
        }
      ]
    },
    {
      "display_name": "Deals",
      "name": "d_deals",
      "values": [
        {
          "display_name": "All Deals",
          "value": "all deals",
          "id": "akkos"
        },
        {
          "display_name": "Buy and Save",
          "value": "buy and save",
          "id": "55e6t"
        },
        {
          "display_name": "GiftCard with Purchase",
          "value": "giftcard with purchase",
          "id": "55e6u"
        },
        {
          "display_name": "Sale",
          "value": "sale",
          "id": "5tdv0"
        },
        {
          "display_name": "Weekly Ad",
          "value": "weekly ad",
          "id": "55dgn"
        }
      ]
    },
    {
      "display_name": "Lead Size",
      "name": "d_lead_size",
      "values": [
        {
          "display_name": "0.5mm",
          "value": "0.5mm",
          "id": "5pxtk9559ri"
        },
        {
          "display_name": "0.7mm",
          "value": "0.7mm",
          "id": "5pxtk9559rj"
        },
        {
          "display_name": "1.0mm",
          "value": "1.0mm",
          "id": "5pxtk95qrby"
        },
        {
          "display_name": "1.6mm",
          "value": "1.6mm",
          "id": "5pxtk9mlxhe"
        },
        {
          "display_name": "Extra Fine",
          "value": "extra fine",
          "id": "5pxtk92jhgy"
        },
        {
          "display_name": "Fine",
          "value": "fine",
          "id": "5pxtk9n6e8u"
        }
      ]
    },
    {
      "display_name": "Finish",
      "name": "d_finish_and_color",
      "values": [
        {
          "display_name": "Black",
          "value": "black",
          "id": "4o3k2"
        },
        {
          "display_name": "Yellow",
          "value": "yellow",
          "id": "4b21u25xkpk"
        },
        {
          "display_name": "Blue",
          "value": "blue",
          "id": "4b21u25xku0"
        },
        {
          "display_name": "Green",
          "value": "green",
          "id": "4b21u25xkwh"
        },
        {
          "display_name": "Orange",
          "value": "orange",
          "id": "4b21u255ivh"
        },
        {
          "display_name": "Pink",
          "value": "pink",
          "id": "4b21u25xkwk"
        },
        {
          "display_name": "Purple",
          "value": "purple",
          "id": "4b21u25xkug"
        }
      ]
    },
    {
      "display_name": "FPO/APO",
      "name": "d_apo_fpo",
      "values": [
        {
          "display_name": "only eligible items",
          "value": "only eligible items",
          "id": "vu13f"
        }
      ]
    },
    {
      "display_name": "Featured",
      "name": "d_marketing",
      "values": [
        {
          "display_name": "New",
          "value": "new",
          "id": "5ewil"
        }
      ]
    }
  ]
}
﻿
RedCircle API returns the following properties for Search requests:
Property
Type
Description
search_results
array
An array of Search Result objects, containing each of the product results shown on the Search Results page. The Search Result object has the following properties:
position
number
The position of the result on the search results page.
Product Object 
The product object contains details about the product within the search result. The product object has the following properties:
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.
﻿
sponsored
boolean
Set to true when the search result is sponsored.
﻿
main_image
string
The primary image URL associated with the product.
﻿
images
array
An array of image URLs for the product.
﻿
videos
array
An array of video objects containing string link and type properties for the URL to the video, and its' MIME type (i.e. video/mp4 ).
﻿
class_id
string
The Target class ID the product belongs to.
﻿
department_id
string
The Target department ID the product belongs to.
﻿
rating
number
The customer rating of this product, out of 5.
﻿
ratings_total
number
The total number of customer ratings this product has received.
﻿
Offers Object
The offers object contains details about the product offers. The offers object has the following properties:
all_offers
array
An array containing all of the offers, in the case of there being multiple. The objects in the all_offers array have the same properties as the primary offer object.
﻿
primary
object
Primary Offer Object 
The primary offer object contains details about the primary seller offer for the product and has the following properties:
﻿
price
number
The price of the seller offer.
﻿
max_price
number
The maximum price of the seller offer in the case of range pricing (min/max).
﻿
min_price
number
The minimum price of the seller offer in the case of range pricing (min/max).
﻿
currency
string
The currency of the seller offer.
﻿
symbol
string
The currency symbol of the seller offer.
﻿
regular_price
number
The regular, undiscounted price, if shown.
﻿
Fulfillment Object
The fulfillment object contains details about the product delivery and pickup options. The fulfillment object 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.
﻿
Seller Object
The seller object contains details the seller (populated when fulfillment.type=1p). 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.
related_queries
array
Related Queries Object
An array containing details of any related queries shown on the search result page. Each object in the related_queries array contains the following properties:
query
string
The related query search term text.
﻿
link
number
The URL to the related query search results.
facets
array
Facet Object
An array containing details of any available result facets (refinements) shown on the search result page. You can use the facets returned here to refine your query by supplying facet information into the facets request parameter . Each object in the facets array contains the following properties:
name
string
The name of the facet.
﻿
display_name
string
The display name of the facet (i.e. the user-facing name).
﻿
values
array
Facet Values Array
The facet values array shows the values of the given facet.
﻿
value
string
The value of the facet.
﻿
display_name
string
The display name of the facet value (i.e. the user-facing name of the facet value).
﻿
id
string
The ID of the facet, can be used in the facets request parameter .
categories
array
Categories Array
An array containing details of the categories (i.e. subcategories) shown on the page. You can use the id of a category to refine your query by supplying facet information into the category_id request parameter . Each object in the categories array contains the following properties:
name
string
The name of the category.
﻿
id
string
The ID of the category (can be used in the category_id request parameter).
pagination
object
Pagination Object
An object containing details of the current 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
object
Current Page Object 
Contains details of the current page
﻿
page
number
The current page number.
﻿
link
string
The current page URL.
﻿
next
object
Next Page Object 
Contains details of the next page
﻿
page
number
The next page number.
﻿
link
string
The next page URL.
﻿
total_pages
number
The total number of pages shown as being available.
﻿
total_results
number
The total number of search results shown as being available.
﻿
Next Steps
     Search Parameters﻿

Property	Type	Description
search_results	array	An array of Search Result objects, containing each of the product results shown on the Search Results page. The Search Result object has the following properties: position number The position of the result on the search results page. Product Object The product object contains details about the product within the search result. The product object has the following properties: 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. sponsored boolean Set to true when the search result is sponsored. main_image string The primary image URL associated with the product. images array An array of image URLs for the product. videos array An array of video objects containing string link and type properties for the URL to the video, and its' MIME type (i.e. video/mp4 ). class_id string The Target class ID the product belongs to. department_id string The Target department ID the product belongs to. rating number The customer rating of this product, out of 5. ratings_total number The total number of customer ratings this product has received. Offers Object The offers object contains details about the product offers. The offers object has the following properties: all_offers array An array containing all of the offers, in the case of there being multiple. The objects in the all_offers array have the same properties as the primary offer object. primary object Primary Offer Object The primary offer object contains details about the primary seller offer for the product and has the following properties: price number The price of the seller offer. max_price number The maximum price of the seller offer in the case of range pricing (min/max). min_price number The minimum price of the seller offer in the case of range pricing (min/max). currency string The currency of the seller offer. symbol string The currency symbol of the seller offer. regular_price number The regular, undiscounted price, if shown. Fulfillment Object The fulfillment object contains details about the product delivery and pickup options. The fulfillment object 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. Seller Object The seller object contains details the seller (populated when fulfillment.type=1p). 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.
related_queries	array	Related Queries Object An array containing details of any related queries shown on the search result page. Each object in the related_queries array contains the following properties: query string The related query search term text. link number The URL to the related query search results.
facets	array	Facet Object An array containing details of any available result facets (refinements) shown on the search result page. You can use the facets returned here to refine your query by supplying facet information into the facets request parameter . Each object in the facets array contains the following properties: name string The name of the facet. display_name string The display name of the facet (i.e. the user-facing name). values array Facet Values Array The facet values array shows the values of the given facet. value string The value of the facet. display_name string The display name of the facet value (i.e. the user-facing name of the facet value). id string The ID of the facet, can be used in the facets request parameter .
categories	array	Categories Array An array containing details of the categories (i.e. subcategories) shown on the page. You can use the id of a category to refine your query by supplying facet information into the category_id request parameter . Each object in the categories array contains the following properties: name string The name of the category. id string The ID of the category (can be used in the category_id request parameter).
pagination	object	Pagination Object An object containing details of the current 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 object Current Page Object Contains details of the current page page number The current page number. link string The current page URL. next object Next Page Object Contains details of the next page page number The next page number. link string The next page URL. total_pages number The total number of pages shown as being available. total_results number The total number of search results shown as being available.

Updated 06 Aug 2024

Did this page help you?

Store Stock