Category
2 min
Category Results
When making a request with the type parameter set to type=category RedCircle API will return category results from Target.
Category results are retrieved from the category results page on Target.
Category Results Page
An example of the JSON object returned from a Category 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/c/-/N-pmrkg?sortBy=bestselling&Nao=0"
},
"request_parameters": {
"type": "category",
"category_id": "pmrkg",
"sort_by": "best_seller"
},
"category_results": [
{
"position": 1,
"product": {
"title": "Little Tikes Easy Store 3' Trampoline",
"link": "https://www.target.com/p/little-tikes-easy-store-3-39-trampoline/-/A-53664704",
"tcin": "53664704",
"dpci": "091-15-2402",
"class_id": 15,
"department_id": 91,
"brand": "Little Tikes",
"brand_link": "https://www.target.com/b/little-tikes/-/N-5xxfx",
"feature_bullets": [
"Enjoy endless hours of bouncing fun",
"Large jumping surface with sturdy handle bars",
"Designed for indoor use"
],
"rating": 4.2,
"ratings_total": 753,
"main_image": "https://target.scene7.com/is/image/Target/GUEST_dc621558-10d2-4672-aeaa-69fb78506415",
"images": [
"https://target.scene7.com/is/image/Target/GUEST_dc621558-10d2-4672-aeaa-69fb78506415",
"https://target.scene7.com/is/image/Target/GUEST_3b433c20-3061-495c-b0d1-65c5bf2dac13",
"https://target.scene7.com/is/image/Target/GUEST_218cd3c2-9f70-4958-afc2-330e96da800a",
"https://target.scene7.com/is/image/Target/GUEST_03ee76a9-78a9-4d65-a2c0-fda2b27871aa",
"https://target.scene7.com/is/image/Target/GUEST_a7911de2-bad0-4457-8869-152c9978ff6c"
],
"videos": [
{
"link": "https://target.scene7.com/is/content/Target/GUEST_39c888ff-2c0f-45d0-abed-e6865cf4d24a_Flash9_Autox720p_2600k",
"type": "video/mp4"
}
]
},
"offers": {
"primary": {
"price": 59.99,
"currency": "USD",
"symbol": "$"
},
"all_offers": [
{
"price": 59.99,
"currency": "USD",
"symbol": "$"
}
]
},
"fulfillment": {
"type": "3p"
},
"seller": {
"name": "MyOfficeInnovations",
"id": "10003960"
}
},
{
"position": 2,
"product": {
"title": "Little Tikes Climb and Slide 7' Trampoline",
"link": "https://www.target.com/p/little-tikes-climb-and-slide-7-39-trampoline/-/A-53664701",
"tcin": "53664701",
"dpci": "091-15-2397",
"class_id": 15,
"department_id": 91,
"brand": "Little Tikes",
"brand_link": "https://www.target.com/b/little-tikes/-/N-5xxfx",
"feature_bullets": [
"3-in-1 FUN - Kids can scramble up the climber, jump on the trampoline and then exit by sliding down the slide",
"SAFE AND DURABLE - Features a sturdy plastic frame, padded protectors to cover the safety springs and zippered enclosures for safe play",
"KIDS STAY ACTIVE - The perfect size with just the right bounce to provide hours of high-energy, bouncing fun",
"GROWS WITH YOUR CHILD - Perfect for a toddler's first trampoline but big enough to accommodate bigger kids, too—holds kids up to 105 pounds",
"CONVENIENT SHOE STORAGE - A shoe holder attached to the bottom of the trampoline helps keep shoes—or whatever kids have in their pockets—together and out of the way"
],
"rating": 3.8,
"ratings_total": 120,
"main_image": "https://target.scene7.com/is/image/Target/GUEST_76193e9c-96d5-4ff7-89da-96713e331191",
"images": [
"https://target.scene7.com/is/image/Target/GUEST_76193e9c-96d5-4ff7-89da-96713e331191",
"https://target.scene7.com/is/image/Target/GUEST_106b7578-a683-435c-9d38-1dda97baa5f0",
"https://target.scene7.com/is/image/Target/GUEST_7bea32b3-1747-4d48-84d2-5c8025c35a0e",
"https://target.scene7.com/is/image/Target/GUEST_f4d2de20-04f2-47d0-81c4-93325ae34576",
"https://target.scene7.com/is/image/Target/GUEST_8ea92431-72e8-4c49-b6f7-bf3556bbabf4"
],
"videos": [
{
"link": "https://target.scene7.com/is/content/Target/GUEST_39c888ff-2c0f-45d0-abed-e6865cf4d24a_Flash9_Autox720p_2600k",
"type": "video/mp4"
}
]
},
"offers": {
"primary": {
"price": 299.99,
"currency": "USD",
"symbol": "$"
},
"all_offers": [
{
"price": 299.99,
"currency": "USD",
"symbol": "$"
}
]
},
"fulfillment": {
"type": "1p"
}
}
],
"pagination": {
"current": {
"page": 1,
"link": "https://www.target.com/c/-/N-pmrkg?sortBy=bestselling&Nao=0"
},
"next": {
"page": 2,
"link": "https://www.target.com/c/-/N-pmrkg?sortBy=bestselling&Nao=24"
},
"total_pages": 7,
"total_results": 146
},
"categories": [
{
"name": "Water Toys",
"id": "5xta8"
},
{
"name": "Lawn Games",
"id": "5xt5p"
},
{
"name": "Toy Sports",
"id": "pmrkg"
},
{
"name": "Swing Sets & Playsets",
"id": "5xtab"
},
{
"name": "Toy Blasters",
"id": "5xtaa"
},
{
"name": "Trampolines",
"id": "pmrkg"
},
{
"name": "Bounce Houses",
"id": "5xtah"
},
{
"name": "Sand Toys",
"id": "obkx9"
},
{
"name": "Sleds, Tubes & Snow Toys",
"id": "5xtac"
},
{
"name": "Bubbles",
"id": "5xtag"
},
{
"name": "Climbers",
"id": "yy2e9"
},
{
"name": "Kickballs & Playground Balls",
"id": "73so2"
},
{
"name": "Sidewalk Chalk",
"id": "6m4ec"
},
{
"name": "Sand & Water Tables",
"id": "rujbf"
},
{
"name": "Ball Pits",
"id": "ggrcn"
},
{
"name": "Pogo Sticks, Hoppers, & Hoops",
"id": "e4l0b"
},
{
"name": "Slides",
"id": "dgggc"
},
{
"name": "Kites",
"id": "hmrv0"
}
],
"facets": [
{
"display_name": "Type",
"name": "d_item_type_all",
"values": [
{
"display_name": "Trampoline Accessories",
"value": "trampoline accessories",
"id": "55p3x"
},
{
"display_name": "Trampolines",
"value": "trampolines",
"id": "55ory"
},
{
"display_name": "Water Trampolines",
"value": "water trampolines",
"id": "55oet"
}
]
},
{
"display_name": "Age",
"name": "d_age_toys",
"values": [
{
"display_name": "0-24 Months",
"value": "0-24 months",
"id": "scy48"
},
{
"display_name": "2 - 4 Years",
"value": "2 - 4 years",
"id": "dyksm"
},
{
"display_name": "5 - 7 Years",
"value": "5 - 7 years",
"id": "5zl3x"
},
{
"display_name": "8 - 10 Years",
"value": "8 - 10 years",
"id": "5zl3y"
},
{
"display_name": "14+ Years",
"value": "14+ years",
"id": "oser0"
}
]
},
{
"display_name": "Max Weight Capacity",
"name": "d_max_weight_capacity",
"values": [
{
"display_name": "50 - 99 lbs",
"value": "50 - 99 lbs",
"id": "sohbz"
},
{
"display_name": "100 - 149 lbs",
"value": "100 - 149 lbs",
"id": "4jgjq"
},
{
"display_name": "150 - 199 lbs",
"value": "150 - 199 lbs",
"id": "9ougp"
},
{
"display_name": "200 - 249 lbs",
"value": "200 - 249 lbs",
"id": "32g9r"
},
{
"display_name": "250 - 299 lbs",
"value": "250 - 299 lbs",
"id": "tbl3"
},
{
"display_name": "300 lbs and above",
"value": "300 lbs and above",
"id": "hbbjw"
}
]
},
{
"display_name": "Shape",
"name": "d_shape_all",
"values": [
{
"display_name": "Round",
"value": "round",
"id": "5y74s"
},
{
"display_name": "Hexagon",
"value": "hexagon",
"id": "s87a2"
},
{
"display_name": "Rectangle",
"value": "rectangle",
"id": "5y70e"
},
{
"display_name": "Oval",
"value": "oval",
"id": "5y68j"
},
{
"display_name": "Octagon",
"value": "octagon",
"id": "5y2fa"
}
]
},
{
"display_name": "Brand",
"name": "d_brand_all",
"values": [
{
"display_name": "Costway",
"value": "costway",
"id": "q643lefe4e4"
},
{
"display_name": "ExacMe",
"value": "exacme",
"id": "q643leuorf2"
},
{
"display_name": "Flybar",
"value": "flybar",
"id": "56gzi"
},
{
"display_name": "HearthSong",
"value": "hearthsong",
"id": "e0b7c"
},
{
"display_name": "Jumpking Trampolines",
"value": "jumpking trampolines",
"id": "z7j2d"
},
{
"display_name": "JumpSport",
"value": "jumpsport",
"id": "9ay9u"
},
{
"display_name": "Little Tikes",
"value": "little tikes",
"id": "5xxfx"
},
{
"display_name": "Moxie Trampolines",
"value": "moxie trampolines",
"id": "q643lewt448"
},
{
"display_name": "Okiedog",
"value": "okiedog",
"id": "q643le4mo89"
},
{
"display_name": "Plum",
"value": "plum",
"id": "q643le64gli"
},
{
"display_name": "ProForm",
"value": "proform",
"id": "55km9"
},
{
"display_name": "Propel Trampolines",
"value": "propel trampolines",
"id": "q643leldwnh"
},
{
"display_name": "Rave Sports",
"value": "rave sports",
"id": "5qhvq"
},
{
"display_name": "SereneLife",
"value": "serenelife",
"id": "q643le31pai"
},
{
"display_name": "Skywalker Trampolines",
"value": "skywalker trampolines",
"id": "jxft9"
},
{
"display_name": "smarTrike",
"value": "smartrike",
"id": "xqn7g"
},
{
"display_name": "SportsPlus",
"value": "sportsplus",
"id": "q643lefg1ma"
},
{
"display_name": "Sportsstuff",
"value": "sportsstuff",
"id": "9t0ey"
},
{
"display_name": "Springfree",
"value": "springfree",
"id": "q643lefr943"
},
{
"display_name": "Stamina",
"value": "stamina",
"id": "5s8rg"
},
{
"display_name": "UpperBounce",
"value": "upperbounce",
"id": "2r6bh"
},
{
"display_name": "XDP Recreation",
"value": "xdp recreation",
"id": "hbwv0"
}
]
},
{
"display_name": "Jumping Area",
"name": "d_jumping_area",
"values": [
{
"display_name": "0 - 40 Inches",
"value": "0 - 40 inches",
"id": "42jb0"
},
{
"display_name": "40 - 80 Inches",
"value": "40 - 80 inches",
"id": "7iw19"
},
{
"display_name": "80 - 120 Inches",
"value": "80 - 120 inches",
"id": "zp89l"
},
{
"display_name": "120 - 160 Inches",
"value": "120 - 160 inches",
"id": "rhnuu"
},
{
"display_name": "160 - 200 Inches",
"value": "160 - 200 inches",
"id": "qgmim"
}
]
},
{
"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": "$200 - $300",
"value": "$200 - $300",
"id": "5zja8"
},
{
"display_name": "$300 - $500",
"value": "$300 - $500",
"id": "5zja9"
},
{
"display_name": "$500 - $800",
"value": "$500 - $800",
"id": "5zjaa"
},
{
"display_name": "$800 - $1000",
"value": "$800 - $1000",
"id": "5zjab"
},
{
"display_name": "$1000 - $1500",
"value": "$1000 - $1500",
"id": "5zjac"
},
{
"display_name": "$1500 - $5000",
"value": "$1500 - $5000",
"id": "5zjad"
}
]
},
{
"display_name": "Deals",
"name": "d_deals",
"values": [
{
"display_name": "All Deals",
"value": "all deals",
"id": "akkos"
},
{
"display_name": "Sale",
"value": "sale",
"id": "5tdv0"
}
]
},
{
"display_name": "Featured",
"name": "d_marketing",
"values": [
{
"display_name": "New",
"value": "new",
"id": "5ewil"
}
]
},
{
"display_name": "FPO/APO",
"name": "d_apo_fpo",
"values": [
{
"display_name": "only eligible items",
"value": "only eligible items",
"id": "vu13f"
}
]
},
{
"display_name": "Capacity",
"name": "d_capacity_all",
"values": [
{
"display_name": "1 Person",
"value": "1 person",
"id": "5xvqt"
},
{
"display_name": "2 People",
"value": "2 people",
"id": "atu5n"
},
{
"display_name": "3 People",
"value": "3 people",
"id": "c4xe"
},
{
"display_name": "4 People",
"value": "4 people",
"id": "vp0nq"
},
{
"display_name": "5 People",
"value": "5 people",
"id": "1xb8w"
},
{
"display_name": "6 People",
"value": "6 people",
"id": "kai4o"
}
]
},
{
"display_name": "Color",
"name": "d_color_all",
"values": [
{
"display_name": "Beige",
"value": "beige",
"id": "5y6q6"
},
{
"display_name": "Black",
"value": "black",
"id": "5y761"
},
{
"display_name": "Blue",
"value": "blue",
"id": "5y70h"
},
{
"display_name": "Brown",
"value": "brown",
"id": "5y746"
},
{
"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": "Material",
"name": "d_material_all",
"values": [
{
"display_name": "Canvas",
"value": "canvas",
"id": "5y6cw"
},
{
"display_name": "Elastic",
"value": "elastic",
"id": "5u01a"
},
{
"display_name": "Iron",
"value": "iron",
"id": "5y6ex"
},
{
"display_name": "Metal",
"value": "metal",
"id": "5y716"
},
{
"display_name": "Nylon",
"value": "nylon",
"id": "5y77x"
},
{
"display_name": "Plastic",
"value": "plastic",
"id": "5y763"
},
{
"display_name": "Polyester",
"value": "polyester",
"id": "5y745"
},
{
"display_name": "Polyethylene",
"value": "polyethylene",
"id": "5xvu6"
},
{
"display_name": "Polypropylene",
"value": "polypropylene",
"id": "5xypx"
},
{
"display_name": "Polyurethane Foam",
"value": "polyurethane foam",
"id": "5y0lx"
},
{
"display_name": "PVC (Polyvinyl Chloride)",
"value": "pvc (polyvinyl chloride)",
"id": "kr09z"
},
{
"display_name": "PVC Coated Polyester",
"value": "pvc coated polyester",
"id": "5tqvm"
},
{
"display_name": "Steel",
"value": "steel",
"id": "5y6p4"
},
{
"display_name": "Vinyl",
"value": "vinyl",
"id": "5y70r"
}
]
},
{
"display_name": "Trending",
"name": "d_baby_trends",
"values": [
{
"display_name": "Best of Baby - Online Exclusives",
"value": "best of baby - online exclusives",
"id": "h1iv3"
}
]
},
{
"display_name": "Care and Cleaning",
"name": "d_care_and_cleaning",
"values": [
{
"display_name": "Air Dry",
"value": "air dry",
"id": "b52yf"
},
{
"display_name": "Clean With Water",
"value": "clean with water",
"id": "lzn8y"
},
{
"display_name": "Spot Clean",
"value": "spot clean",
"id": "t09ba"
}
]
},
{
"display_name": "Features",
"name": "d_features_all",
"values": [
{
"display_name": "Button Closure",
"value": "button closure",
"id": "5dnhf"
},
{
"display_name": "Covered Springs",
"value": "covered springs",
"id": "5t4va"
},
{
"display_name": "Foam Padding",
"value": "foam padding",
"id": "5xnb8"
},
{
"display_name": "Handlebar",
"value": "handlebar",
"id": "1rvvyybux32"
},
{
"display_name": "Indoor Use",
"value": "indoor use",
"id": "5xqyu"
},
{
"display_name": "Outdoor Use",
"value": "outdoor use",
"id": "5xr5v"
},
{
"display_name": "Padded Stability Handle",
"value": "padded stability handle",
"id": "56fz7"
},
{
"display_name": "Reinforced Sockets",
"value": "reinforced sockets",
"id": "56d7e"
},
{
"display_name": "Stretch Band Bouncing",
"value": "stretch band bouncing",
"id": "e5lbx"
},
{
"display_name": "Zipper Closure",
"value": "zipper closure",
"id": "5y6cu"
}
]
}
]
}RedCircle API returns the following properties for Category requests:
Property | Type | Description |
|---|---|---|
category_results | array | An array of Category Result objects, containing each of the product results shown on the Category Results page. The Category Result object has the following properties:
Product Object The product object contains details about the product within the category 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 category 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:
|
breadcrumbs | array | Breadcrumbs Array An array containing details of the categories shown in the breadcrumbs. Each object in the 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 Category Parameters