Store Stock

3 min

Store Stock Results

When making a request with the type parameter set to type=store_stock RedCircle API will retrieve in-store stock information of a single product on Target - the product is specified using either the tcin , dpci or url parameter (where the url parameter contains a link to an Target product page).

The location to perform the search is specified using the store_stock_zipcode parameter. Up to 20 stores within a 50 mile radius of the specified zipcode will be returned in the store_stock_results array.

Store stock details are retrieved from the store stock check page for a single product on Target.

Store Stock Page

An example of the JSON object returned from an Store Stock 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.001Z",
    "total_time_taken": 0.1,
    "target_url": "https://www.target.com/p/-/A-78025470"
  },
  "request_parameters": {
    "type": "store_stock",
    "store_stock_zipcode": "52404",
    "tcin": "78025470"
  },
  "store_stock_results": [
    {
      "position": 1,
      "store_name": "Cedar Rapids South",
      "store_id": "1771",
      "in_stock": true,
      "stock_level": 13,
      "address": "3400 Edgewood Rd SW",
      "city": "Cedar Rapids",
      "state": "Iowa",
      "zipcode": "52404-7214",
      "phone": "319-396-4444",
      "distance": 1.58
    },
    {
      "position": 2,
      "store_name": "Cedar Rapids North",
      "store_id": "1768",
      "in_stock": true,
      "stock_level": 2,
      "address": "1030 Blairs Ferry Rd NE",
      "city": "Cedar Rapids",
      "state": "Iowa",
      "zipcode": "52402-1220",
      "phone": "319-393-1600",
      "distance": 6.54
    },
    {
      "position": 3,
      "store_name": "Coralville",
      "store_id": "1113",
      "in_stock": true,
      "stock_level": 5,
      "address": "1441 Coral Ridge Ave",
      "city": "Coralville",
      "state": "Iowa",
      "zipcode": "52241-2801",
      "phone": "319-351-5150",
      "distance": 18.13
    },
    {
      "position": 4,
      "store_name": "Iowa City Downtown",
      "store_id": "3374",
      "in_stock": true,
      "stock_level": 8,
      "address": "113 E. Washington St",
      "city": "Iowa City",
      "state": "Iowa",
      "zipcode": "52240-3925",
      "phone": "319-471-4912",
      "distance": 21.25
    },
    {
      "position": 5,
      "store_name": "Waterloo",
      "store_id": "1792",
      "in_stock": true,
      "stock_level": 6,
      "address": "1501 E San Marnan Dr",
      "city": "Waterloo",
      "state": "Iowa",
      "zipcode": "50702-4300",
      "phone": "319-226-6500",
      "distance": 48.63
    }
  ],
  "product": {
    "tcin": "78025470",
    "dpci": "081-02-3451"
  }
}

RedCircle API returns the following properties for Store Stock requests:

Property	Type	Description
store_stock_results	array	An array containing up to 20 Store Stock objects showing in-store stock status for the requested tcin in stores within a 50-mile radius of the requested store_stock_zipcode . position string The position of the result in the store_stock_results array. in_stock boolean Set to true if this store has stock of the given tcin , otherwise false . stock_level number The quantity of stock available in the given store, if shown. address string The address of the store the request was run in. city string The city the request was run in. state string The state the request was run in. zipcode string The zipcode the request was run in. phone string The phone number of the store, if shown. store_name string The name of the store that the request was run from. store_id string The ID of the store that the request was run from. distance number The distance, in fractional miles, of the store from the zipcode specified in the store_stock_zipcode request parameter.
product	object	An object containing details of the product for which in-store stock data was requested. tcin string The product TCIN (Target product ID). dpci string The Target "Department - Class - Item" ID of the product.

Next Steps Store Stock Parameters