---
title: Search
slug: redcircleapi/target-product-data-api/results/search
docTags:
createdAt: 2024-07-27T14:22:43.825Z
---
# Search Results
When making a request with the `type` [parameter](https://docs.trajectdata.com/redcircleapi/target-product-data-api/parameters/search) set to `type=search` RedCircle API will return search results from Target.
Search results are retrieved from the [search results page](https://www.target.com/s?searchTerm=highlighter+pens) on Target.
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"
}
]
}
]
}
```
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:
-
1. `price`
2. `number`
3. The price of the seller offer.
-
1. `max_price`
2. `number`
3. The maximum price of the seller offer in the case of range pricing (min/max).
-
1. `min_price`
2. `number`
3. The minimum price of the seller offer in the case of range pricing (min/max).
-
1. `currency`
2. `string`
3. The currency of the seller offer.
-
1. `symbol`
2. `string`
3. The currency symbol of the seller offer.
-
1. `regular_price`
2. `number`
3. 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 ](https://docs.trajectdata.com/redcircleapi/target-product-data-api/parameters/search). 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.
-
1. `value`
2. `string`
3. The value of the facet.
-
1. `display_name`
2. `string`
3. The display name of the facet value (i.e. the user-facing name of the facet value).
-
1. `id`
2. `string`
3. The ID of the facet, can be used in the `facets` [request parameter ](https://docs.trajectdata.com/redcircleapi/target-product-data-api/parameters/search). |
| *`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 ](https://docs.trajectdata.com/redcircleapi/target-product-data-api/parameters/search). 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 ](https://docs.trajectdata.com/redcircleapi/target-product-data-api/parameters/search).
- `current`
- `object`
- **Current Page Object
**
Contains details of the current page
-
1. `page`
2. `number`
3. The current page number.
-
1. `link`
2. `string`
3. The current page URL.
- `next`
- `object`
- **Next Page Object
**
Contains details of the next page
-
1. `page`
2. `number`
3. The next page number.
-
1. `link`
2. `string`
3. 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](https://docs.trajectdata.com/redcircleapi/target-product-data-api/parameters/search)