Target

Shopping

Target's app provides a curated, conversational shopping experience right within ChatGPT. It allows shoppers to ask for ideas, browse and build multi-item baskets, shop for fresh food, and check out using their choice fulfillment options — including Drive Up, Order Pickup, and Shipping. For example, a guest can tag the Target app in ChatGPT and say, “Help me plan a family holiday movie night,” and instantly get curated ideas — cozy blankets, candles, snacks, slippers, and more. They can browse the options, build the perfect basket, and check out through their Target account. And soon, Target will add new features like Target Circle linking and same-day delivery.

7ChatGPT Tools

ShoppingCategory

Available Tools

Check Availability

checkAvailability

Full Description

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.

Parameters (1 required, 3 optional)

Required

tcinstring

Target item number (TCIN)

Optional

scheduled_delivery_store_idstring

Store ID for scheduled delivery (optional)

store_idstring

Store ID for pickup (optional)

zipstring

ZIP code for availability check (optional)

Get Item Attributes

getItemAttributes

Full Description

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

Parameters (1 required, 2 optional)

Required

tcinstring

Target item number (TCIN)

Optional

pricing_store_idstring

Store ID for pricing information of the item at the specific store.

Default: 1771

store_idstring

Store ID for giving the exact location of the item in the store.

Default: 1771

Get Nearby Stores

getNearbyStores

Full Description

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.

Parameters (1 required, 3 optional)

Required

placestring

5 digit Zip code/postal code to find nearby stores within the specified radius.

Optional

capabilitiesstring

Filter stores by capability. Use 'Shipt Delivery' to find Same Day Delivery (SDD) eligible stores. Omit this parameter to return all nearby stores regardless of capability.

Options:Shipt Delivery

limitnumber

Number of nearby stores to return (default is 5).

Default: 5

withinnumber

Search radius in miles (default is 25).

Default: 25

Get Similar Items

listSimilarItems

Full Description

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

Parameters (1 required, 5 optional)

Required

tcinsstring

Target item number (TCIN)

Optional

channelstring

Channel through which the request is made.

Default: WEB

pagestring

Page number for pagination.

Default: redsky_mcp

placement_idstring

Placement ID for the item placement context.

Default: adaptpdph3

pricing_store_idstring

Store ID for pricing information of the item at the specific store.

Default: 1771

visitor_idstring

Visitor ID for tracking user sessions.

Default: 1234

Multi Category Search Items

multiCategorySearchItems

Full Description

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.

Parameters (1 required, 25 optional)

Required

keywordstring

BM25-optimized search query with specific product attributes. DO NOT use natural-language sentences. Construct keyword-rich queries containing: category + brand/material/features + modifiers (color, size, use-case). Preserve all user constraints (price, style, occasion) as attributes, not prose. Examples: 'boho flowy sundress women beach vacation' (NOT 'a boho sundress for the beach'), 'black hardside carry-on luggage spinner wheels' (NOT 'suitcase with wheels'), 'Sony WH-1000XM5 wireless noise-canceling headphones' (NOT 'good wireless headphones'). Be specific and consistent—use the same terms for the same products across conversations.

Optional

channelstring

Channel through which the request is made.

Default: WEB

constraintsobject

Optional structured constraints extracted from the prompt. If the user didn’t specify a facet, omit it (especially sizes and colors). Only use colors when facet_value_id is found in color_to_facet_value_map; otherwise omit colors.

countinteger

Results per page. Max 28.

Default: 24

dealsboolean

Set true when the user asks for any kind of deals. If unsure, prefer false.

Default: False

deals_typestring

Model's best interpretation of the kind of deals the user is requesting. Pick one from the provided enum list. If unsure, prefer 'unknown'.

Options:All DealsBlack FridayCircle WeekCyber MondayNew Lower PriceTarget Circle DealsWeekly AdClearanceunknown

Default: unknown

external_searchboolean

True if search is initiated from an external source.

Default: True

fan_outobject

Present for multi-category intents. Build 2–8 category-specific queries without asking questions. Avoid duplicates and carry forward constraints (e.g., under $50, boho, beach).

include_fulfillmentboolean

Include fulfillment options in the response (boolean, not string).

Default: True

intent_typestring

Model’s best interpretation of the user’s shopping intent.

Options:single_categorymulti_categoryoutfit_lookbroad_inspirationunknown

Default: unknown

is_multi_categoryboolean

Set true when the user asks for outfits/looks/gift ideas or mixes apparel + accessories (e.g., dress + sandals + sunglasses). If unsure, prefer true.

Default: False

is_multi_facetedboolean

Set true when multiple constraints are requested simultaneously (e.g., price + style + occasion).

Default: False

max_pricenumber

If there is a price range mentioned by the user, use the upper price bound in shopper currency to populate this field. If no mention of price in user query, then ignore this field.

min_pricenumber

If there is a price range mentioned by the user, use the lower price bound in shopper currency to populate this field. If no mention of price in user query, then ignore this field.

new_searchboolean

True if this is an initial typed search not modified by filters.

Default: True

offsetinteger

Zero‑based start index of the result set.

Default: 0

pagestring

Page identifier for telemetry/routing.

Default: redsky_mcp

price_rangearray

If there is a price range mentioned by the user, populate this field with the enum value that closely matches with user preference. Otherwise, ignore this field and use min_price and max_price fields respectively.

pricing_store_idstring

Store ID for pricing at a specific store.

Default: 1771

raw_user_promptstring

Verbatim copy of the user’s last message. Do not edit or paraphrase.

redirectboolean

Use this flag to indicate whether search results should follow redirects. Always set this to false to avoid receiving empty search results when a keyword matches a category search redirect.

Default: False

requested_categoriesarray

Up to 6 free‑text category names inferred from the prompt (e.g., “dresses”, “sandals”, “sunglasses”).

scheduled_delivery_store_idstring

Store ID for pricing information of the item at the specific store.

Default: 1771

sort_bystring

Sort order for search results.

Options:relevanceFeaturedPriceLowPriceHighRatingHighbestsellingnewest

Default: relevance

store_idstring

Store ID for pricing information of the item at the specific store.

Default: 1771

visitor_idstring

Visitor ID for tracking user sessions.

Default: 1234

Multiple Item Availability

multipleItemAvailability

Full Description

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

Parameters (6 required, 6 optional)

Required

channelstring

has_pricing_store_idboolean

pagestring

pricing_store_idstring

store_idstring

tcinstring

Optional

has_financing_optionsboolean

include_obsoleteboolean

is_botboolean

skip_personalizedboolean

skip_variation_hierarchyboolean

visitor_idstring

Search Items

searchItems

Full Description

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.

Parameters (1 required, 21 optional)

Required

keywordstring

Optional

channelstring

Channel through which the request is made.

Default: WEB

countnumber

results per page- max value of 28 is allowed

Default: 24

dealsboolean

Set true when the user asks for any kind of deals. If unsure, prefer false.

Default: False

deals_typestring

Model's best interpretation of the kind of deals the user is requesting. Pick one from the provided enum list. If unsure, prefer 'unknown'.

Options:All DealsBlack FridayCircle WeekCyber MondayNew Lower PriceTarget Circle DealsWeekly AdClearanceunknown

Default: unknown

exclude_facetsstring

Comma separated list of facet names to be excluded from the response.

Default: ALL

external_searchboolean

Indicates if this search is from an external source

Default: True

faceted_valuestring

Comma separated list of faceted values to filter the search results.

include_facetsstring

Comma separated list of facet names to be included in the response.

Default: d_categorytaxonomy,d_channel,d_deals,d_brand_all,d_rating,d_price

include_fulfillmentboolean

Flag to include fulfillment options in the response.

Default: True

max_pricenumber

If there is a price range mentioned by the user, use the upper price bound in shopper currency to populate this field. If no mention of price in user query, then ignore this field.

min_pricenumber

If there is a price range mentioned by the user, use the lower price bound in shopper currency to populate this field. If no mention of price in user query, then ignore this field.

new_searchboolean

Indicates this is an initial new typed search not modified by filters

Default: True

offsetnumber

starting number of the results set

Default: 0

pagestring

Page number for pagination.

Default: redsky_mcp

price_rangearray

pricing_store_idstring

Store ID for pricing information of the item at the specific store.

Default: 1771

redirectboolean

Use this flag to indicate whether search results should follow redirects. Always set this to false to avoid receiving empty search results when a keyword matches a category search redirect.

Default: False

scheduled_delivery_store_idstring

Store ID for pricing information of the item at the specific store.

Default: 1771

sort_bystring

Sort order for search results.

Options:relevanceFeaturedPriceLowPriceHighRatingHighbestsellingnewest

Default: relevance

store_idstring

Store ID for pricing information of the item at the specific store.

Default: 1771

visitor_idstring

Visitor ID for tracking user sessions.

Default: 1234

Links

Website Privacy Policy Terms of Service