Category

category results when making a request with the type parameter https //docs trajectdata com/redcircleapi/target product data api/parameters/category set to type=category redcircle api will return category results from target category results are retrieved from the category results page https //www target com/c/ /n pmrkg on target 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 position number the position of the result on the category results page product object the product object contains details about the product within the category 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 category 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/category 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 https //docs trajectdata com/redcircleapi/target product data api/parameters/category 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/category 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) breadcrumbs array breadcrumbs array an array containing details of the categories shown in the breadcrumbs each object in the array contains the following properties name string the name of the category (i e "toys") link string the link to the category category id string if shown, the category id of the category can we used in a future type=category requests category id request parameter to retrieve other products in this category 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/category 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 category parameters https //docs trajectdata com/redcircleapi/target product data api/parameters/category