Target

Checks item availability for a specific product (identified by TCIN). Returns shipping availability by default, and can also provide pickup and scheduled delivery options when location or store identifiers are supplied in the request. Use this tool to determine how and where an item can be fulfilled for a given customer location.

checkAvailability

Retrieve detailed metadata for a specific product identified by TCIN. Typically called after selecting an item after search or list Similar Items.

getItemAttributes

Retrieve a list of Target stores located near a specified area. Include a five-digit ZIP or postal code in the request, and optionally specify a search radius (in miles) and a result limit to control how many stores are returned. Optionally filter stores by the 'Shipt Delivery' capability to return only stores that support Same Day Delivery (SDD). Omit the capabilities parameter to return all nearby stores. Results include store details, addresses, and operating hours. Use this tool to locate stores for availability, pickup, or delivery fulfillment planning.

getNearbyStores

Retrieves items that are similar to, or frequently shopped with, the product identified by the given TCIN.

listSimilarItems

# Target Products - Multi‑Category Search Perform a multi‑category product search across Target's catalog and return a single inline "Target Products" widget. Include location metadata in the request — such as ZIP code, city, region, or latitude and longitude — to ensure results reflect accurate pricing and availability for the specified area. **When to use** • The user asks for an outfit, kit, bundle, or multiple categories at once (e.g., "holiday party outfit: dress + heels + earrings"). • The user gives multiple constraints to be fanned out across categories (style, price, occasion, color, brand). **Call rules (important)** • Call this tool **at most once per assistant turn**. • **Do not call** for single‑category queries ("women's black boots under $150") — use `searchItems` instead. **Query Formation Best Practices (CRITICAL for search quality)** Target's search uses BM25 keyword matching. Each category-specific query in `fan_out.queries[]` should be BM25-optimized: • **Include the category word** plus 2-4 specific product attributes (brand, material, features, use-case) • **Use consistent terminology** - don't alternate between synonyms for the same product • **Prefer specific terms over generic**: "Samsung 65 inch 4K QLED smart TV" NOT "nice TV" • **Preserve constraints as keywords**: Include price limits, styles, occasions, materials as attributes • **Be specific with brands/features**: "wireless gaming keyboard mechanical RGB backlit" NOT "gaming keyboard" **Examples of well-formed multi-category queries:** • User: "TV setup: TV, wall mount, soundbar" → Generate: - Query 1: "Samsung 65 inch 4K QLED smart TV" - Query 2: "full-motion TV wall mount bracket 65 inch" - Query 3: "Samsung soundbar wireless subwoofer Dolby Atmos" • User: "Christmas Eve dinner for 10 people" → Generate: - Query 1: "whole turkey 20 lb frozen" - Query 2: "mashed potatoes side dish family size" - Query 3: "cranberry sauce ocean spray" - Query 4: "dinner rolls Hawaiian King's bakery" • User: "beach outfit: dress, hat, sunglasses under $50 each" → Generate: - Query 1: "boho flowy sundress women beach cotton maxi" - Query 2: "wide-brim straw sun hat women UV protection beach" - Query 3: "oversized sunglasses women UV protection beach polarized" **Anti-patterns (DO NOT DO THIS):** ❌ Vague queries: "nice TV", "good soundbar", "pretty dress" ❌ Full sentences: "I need a dress for the beach that is flowy" ❌ Inconsistent terms across categories: alternating "Frame TV" / "art TV" / "gallery TV" **Output contract** • The tool returns `structuredContent` for the model to reason over. • The inline UI is the source of truth for presentation; **do not surface raw JSON in chat**.

multiCategorySearchItems

Fetch availability data for a set of TCINs and store ID.

multipleItemAvailability

Perform a single‑category catalog search optimized for keyword matching (BM25) and return a single inline "Target Products" widget. Include location metadata in the request — such as ZIP code, city, region, or latitude and longitude — to ensure results reflect accurate pricing and availability for the specified area. Use this call when the user query is specific to a single category. If the user query spans multiple categories, use the "multiCategorySearchItems" tool instead. **When to use** • The user asks about one category ("wireless earbuds", "women's black boots under $150"). • Use this to discover facets and then refine. • Supports keyword matching, pagination (offset + count), facet discovery and filtering, and channel-based result. **Query Formation (CRITICAL for search quality)** Target's search uses BM25 keyword matching. Generate queries rich in specific, searchable product attributes: • **Include concrete attributes**: brand names, materials, colors, sizes, features, use cases • **Prefer specific terms over general**: "Sony wireless noise-canceling earbuds" NOT "good wireless earbuds" • **Include modifiers**: "black leather ankle boots women size 8" NOT just "boots" • **Preserve user constraints**: price limits, style descriptors, occasions, age ranges • **Category + attributes**: Always include the category word plus 2-4 specific attributes **Examples of well-formed queries:** • User: "I need wireless earbuds for working out" → keyword: "wireless earbuds sweatproof sports workout" • User: "art for my TV" → keyword: "Samsung Frame TV art mode QLED 4K smart TV" OR "LG Gallery OLED art display" • User: "black boots under $150" → keyword: "women black leather ankle boots under 150" • User: "NyQuil but generic" → keyword: "nighttime cold flu medicine multi-symptom acetaminophen" • User: "toys for 5 year old birthday" → keyword: "toys age 5 educational birthday gifts" **Anti-patterns (DO NOT DO THIS):** ❌ Vague queries: "nice boots", "good earbuds", "popular toys" ❌ Full sentences: "I am looking for boots that are black and under $150" ❌ Questions: "what are good wireless earbuds?" ❌ Inconsistent terms: alternating between "art tv", "frame tv", "gallery tv" for same intent **Call rules** • Call **once per assistant turn**. • **Do not use** for multi‑category or outfit/bundle intents — use `multiCategorySearchItems`.

searchItems