Target API: Check store stock
Checks a Target product's stock and pickup, drive-up and same-day delivery availability at the stores nearest a US ZIP code.
Unofficial. Not affiliated with or endorsed by Target.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Product, required
product Product name or Target product link, for example Bounty Select-A-Size Paper Towels.
https://www.target.com/p/bounty-select-a-size-paper-towels-6-triple-rolls/-/A-53274278
- Zip Code, required
zip_code Five-digit US ZIP code, for example 55403.
55403
Exactly 5 characters.
- Max Stores optional
max_stores How many nearby stores to check (1-10), for example 10.
3
Whole number from 1 to 10. Default
10.
Input as JSON
{ "product": "https://www.target.com/p/bounty-select-a-size-paper-towels-6-triple-rolls/-/A-53274278" , "zip_code": "55403", "max_stores": 3}Output
{ "tcin": "53274278", "stores": [ { "address": "900 Nicollet Mall, Minneapolis, MN 55403-2530", "store_id": "1375", "store_url": "https://www.target.com/sl/mpls-nicollet-mall/1375" , "store_name": "Mpls Nicollet Mall", "stock_status": "In stock", "distance_miles": 0.67, "drive_up_available": true, "order_pickup_available": true, "same_day_delivery_available": true }, { "address": "1329 5th St SE, Minneapolis, MN 55414-1390", "store_id": "3200", "store_url": "https://www.target.com/sl/minneapolis-dinkytown/3200" , "store_name": "Minneapolis Dinkytown", "stock_status": "In stock", "distance_miles": 2.61, "drive_up_available": false, "order_pickup_available": true, "same_day_delivery_available": false }, { "address": "2500 E Lake St, Minneapolis, MN 55406-1909", "store_id": "52", "store_url": "https://www.target.com/sl/east-lake-street-and-hwy-55/52" , "store_name": "East Lake Street and Hwy 55", "stock_status": "In stock", "distance_miles": 2.79, "drive_up_available": true, "order_pickup_available": true, "same_day_delivery_available": true } ], "product_url": "https://www.target.com/p/bounty-select-a-size-paper-towels-6-triple-rolls/-/A-53274278" , "product_name": "Bounty Select-A-Size Paper Towels - 6 Triple Rolls - 2-Ply - 123 Sheets"}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"target.com/check_store_stock","input":{"product":"https://www.target.com/p/bounty-select-a-size-paper-towels-6-triple-rolls/-/A-53274278","zip_code":"55403","max_stores":3}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "target.com/check_store_stock" , "input": { "product": "https://www.target.com/p/bounty-select-a-size-paper-towels-6-triple-rolls/-/A-53274278" , "zip_code": "55403", "max_stores": 3 }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "target.com/check_store_stock" , "input": { "product": "https://www.target.com/p/bounty-select-a-size-paper-towels-6-triple-rolls/-/A-53274278" , "zip_code": "55403", "max_stores": 3 } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run target.com/check_store_stock# with {"product":"https://www.target.com/p/bounty-select-a-size-paper-towels-6-triple-rolls/-/A-53274278","zip_code":"55403","max_stores":3}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [ "product", "zip_code" ], "properties": { "product": { "type": "string", "description": "Product name or Target product link, for example Bounty Select-A-Size Paper Towels." }, "zip_code": { "type": "string", "maxLength": 5, "minLength": 5, "description": "Five-digit US ZIP code, for example 55403." }, "max_stores": { "type": "integer", "default": 10, "maximum": 10, "minimum": 1, "description": "How many nearby stores to check (1-10), for example 10." } }}Output schema
{ "type": "object", "required": [ "product_name", "product_url", "tcin", "stores" ], "properties": { "tcin": { "type": "string" }, "stores": { "type": "array", "items": { "type": "object", "required": [ "store_name", "address", "distance_miles", "stock_status", "order_pickup_available", "drive_up_available", "same_day_delivery_available", "store_url", "store_id" ], "properties": { "address": { "type": "string" }, "store_id": { "type": "string" }, "store_url": { "type": "string" }, "store_name": { "type": "string" }, "stock_status": { "enum": [ "In stock", "Limited stock", "Out of stock" ], "type": "string" }, "distance_miles": { "type": [ "number", "null" ] }, "drive_up_available": { "type": "boolean" }, "order_pickup_available": { "type": "boolean" }, "same_day_delivery_available": { "type": "boolean" } } } }, "product_url": { "type": "string" }, "product_name": { "type": "string" } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
target.com/check_store_stock- Returns
- product name, URL, TCIN and per-store stock and fulfillment availability
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method target.com/check_store_stock with the inputs above.
Ask your agent
- Is the Bounty Select-A-Size paper towel 6-pack in stock at the Target stores closest to 55403 for pickup today?
- Check which nearby stores have the Hydro Flask 32 oz water bottle available for same-day delivery to ZIP 30308.
- Can you see stock levels for Apple AirPods Pro at the 5 closest Target locations to 98101, including drive-up options?
- I need the TCIN and per-store availability for a Dyson V8 vacuum across the 8 nearest stores to 60614.
- Look up whether the Lego Star Wars Millennium Falcon set is available for pickup at the 3 nearest stores to zip 85004.
See more
All Target methodsSearches Target products and returns prices, ratings, photos and product links. Prices can vary by store, so you can give a ZIP code for local pricing.
target.com/search_productsChecks a Best Buy product's price, shipping estimate, and pickup availability at the stores nearest a US ZIP code, by product name or Best Buy product link. Availability can change before checkout.
bestbuy.com/check_store_stockChecks a product's price and stock at IKEA stores in a country. Store stock and delivery options appear only where IKEA provides them.
ikea.com/check_store_stockChecks in-store pickup availability for an exact Apple product configuration (name or part number) near a ZIP, postal code or city, listing nearby Apple Stores by distance with their pickup messages. No reservation is made.
apple.com/check_store_pickupSearches a named Instacart store's guest-visible grocery products for a US ZIP code. Prices are in USD and can differ from in-store prices; stock estimates can change.
instacart.com/search_productsFinds a Lowe's product by name, item number or product link and returns its details, price, specifications, images and availability at the nearest store for a ZIP code (or the site's default store).
lowes.com/get_productGets details, price and availability for a Walmart product by name or product link, using Walmart's default location.
walmart.com/get_productSearches Trader Joe's public product catalogue by name or keywords, optionally within a main category. Prices are website reference prices and may vary by store.
traderjoes.com/search_products