Search
2 min
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:
{
"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:
Product Object The product object contains details about the product within the search result. The product object has the following properties:
Offers Object The offers object contains details about the product offers. The offers object has the following properties:
Fulfillment Object The fulfillment object contains details about the product delivery and pickup options. The fulfillment object has the following properties:
Seller Object The seller object contains details the seller (populated when fulfillment.type=1p). It has the following properties:
|
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:
|
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:
|
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:
|
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 .
|
Next Steps Search Parameters