Store Stock

3min

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:
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.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"
  }
}
{
  "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﻿

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.

Updated 16 Aug 2024

Did this page help you?

Reviews

GTIN/ISBN/UPC to Target TCIN Lookups