E-commerce & Marketplaces
Target Product Recommendations API — Alternatives & Also Viewed
Send a Target TCIN or product URL and this source returns the related products Target recommends alongside it: title, TCIN, price, discount, rating and badges.
Example response
{
"session_id": "11111111-1111-1111-1111-111111111111",
"kind": "target_products_recommendations",
"product": "86216189",
"product_id": "86216189",
"type": "alternatives",
"max_items": 2,
"start_page": 1,
"partial": false,
"human": "# Target product recommendations\n\n- **Product (TCIN):** 86216189\n- **Type:** alternatives\n- **Starting page:** 1\n- **Max items:** 2\n- **Records returned:** 2\n- **Proxy traffic:** 37.6 KB",
"machine": {
"total_items": 2,
"first_item": {
"id": "92538311",
"url": "https://www.target.com/p/lego-creator-3-in-1-wild-animals-surprising-spider-building-toy-with-3-options-scorpion-or-snake-31159/-/A-92538311",
"alias": "lego-creator-3-in-1-wild-animals-surprising-spider-building-toy-with-3-options-scorpion-or-snake-31159",
"brand": null,
"title": "LEGO Creator 3 in 1 Wild Animals Surprising Spider Building Toy with 3 Options Scorpion or Snake 31159",
"price": 7.19,
"list_price": 8.99,
"currency": "USD",
"save_percent": 20,
"is_on_sale": true,
"image": "https://target.scene7.com/is/image/Target/GUEST_d3e5d017-e003-4bdf-b379-d1516216de06",
"rating": 4.85,
"rating_count": 233,
"category_id": null,
"parent_category_id": null,
"badges": [
"Rarely returned",
"Highly rated"
]
},
"items": [
{
"id": "92538311",
"url": "https://www.target.com/p/lego-creator-3-in-1-wild-animals-surprising-spider-building-toy-with-3-options-scorpion-or-snake-31159/-/A-92538311",
"alias": "lego-creator-3-in-1-wild-animals-surprising-spider-building-toy-with-3-options-scorpion-or-snake-31159",
"brand": null,
"title": "LEGO Creator 3 in 1 Wild Animals Surprising Spider Building Toy with 3 Options Scorpion or Snake 31159",
"price": 7.19,
"list_price": 8.99,
"currency": "USD",
"save_percent": 20,
"is_on_sale": true,
"image": "https://target.scene7.com/is/image/Target/GUEST_d3e5d017-e003-4bdf-b379-d1516216de06",
"rating": 4.85,
"rating_count": 233,
"category_id": null,
"parent_category_id": null,
"badges": [
"Rarely returned",
"Highly rated"
]
},
{
"id": "89144367",
"url": "https://www.target.com/p/lego-city-fire-rescue-helicopter-pretend-play-toy-60411/-/A-89144367",
"alias": "lego-city-fire-rescue-helicopter-pretend-play-toy-60411",
"brand": null,
"title": "LEGO City Fire Rescue Helicopter Pretend Play Toy 60411",
"price": 9.99,
"list_price": 9.99,
"currency": "USD",
"save_percent": null,
"is_on_sale": false,
"image": "https://target.scene7.com/is/image/Target/GUEST_6cdd9c17-64da-4710-853d-df37c1a24410",
"rating": 4.89,
"rating_count": 81,
"category_id": null,
"parent_category_id": null,
"badges": [
"Rarely returned",
"Highly rated"
]
}
],
"proxy_traffic_bytes": 38493
},
"total_points": 2
}- You send
- A Target TCIN or product URL, with an optional recommendation type, max_items and start_page
- You get back
- Recommended products with title, TCIN, price, discount, rating and badges
- Coverage
- What Target.com shows publicly for the request.
- Price
- 1 point per returned product, up to 500 per request — $1 per 1,000
- Billed per record actually returned, capped by max_items. A request that returns nothing costs nothing.
Comparison
Ways to get this data
Three approaches teams use today, and where each one runs into trouble.
| Approach | What it takes | Cost | Trade-off |
|---|---|---|---|
| Browsing the site by hand | Open the product page and scroll the carousels | Free, and slow | Fine for one item, useless across a catalog |
| Building a scraper | Write it, host it, and repair it when Target changes the results page | Engineering time | A maintenance commitment for something that isn't your product |
| NeuralVerge | One request, the input and options as parameters | $1 per 1,000, misses not billed | A broad request returns a broad — and larger, more expensive — result set |
Response
What you get back
Every field in the response shown above.
| Field | Type | Description |
|---|---|---|
total_items | number | How many products were returned in this batch (capped by max_items). |
id | string | Target item ID (TCIN). |
url | string | Direct link to the product page. |
alias | string | URL slug of the product page. |
brand | string | Brand as listed; null when none is shown. |
title | string | Listing title. |
price | number | Current price. |
list_price | number | Pre-discount price, when the item is on sale. |
currency | string | ISO currency code. |
save_percent | number | Discount percentage shown on the listing. |
is_on_sale | boolean | Whether the item is currently on sale. |
image | string | Primary product image URL. |
rating | number | Average star rating. |
rating_count | number | Number of ratings. |
category_id | string | Target category ID the item is filed under; null when not shown. |
parent_category_id | string | ID of the parent category; null when not shown. |
badges | array | Badges shown on the recommendation, such as Rarely returned. |
first_item | object | Copy of the first result, for quick access. |
Integration
How to run it
The same lookup works from the app, the API, or as a tool an agent can call mid-task.
product is the only required field. type chooses the recommendation set (alternatives, also_viewed, complementary, deals, top_performing, newness or similar). max_items caps the result count (up to 500, defaults to 25) and sets what you are billed for.
curl -X POST https://api.neuralverge.ai/functions/v1/run-target-products-recommendations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "product": "86216189", "type": "alternatives", "max_items": 25 }'Use cases
What teams use it for
Where this field shows up in an actual workflow.
Competitive mapping
See which products Target presents as alternatives to yours.
Bundle research
Use the complementary set to find what is commonly paired with an item.
Deal spotting
Pull the deals set for an item to see which related products are discounted.
Assortment gaps
Compare the similar and top_performing sets to see what a category is missing.
Coverage & limits
Coverage, freshness and limits
What this source covers, how fresh it is, and where it stops.
Coverage
What Target.com shows publicly for the request.
Freshness
Read at request time.
Handling
This source returns publicly visible product information, stamped with the input it was read from and a session id you can trace.
What it will not do
- —The sets are what Target chooses to show at request time and change as its recommendations change.
- —Brand and category IDs can be null on recommended products.
- —Not every product has every recommendation type.
FAQ
Questions, answered
alternatives, also_viewed, complementary, deals, top_performing, newness and similar.
Related
Related sources
Try target product recommendations on your own data
One request format across every source in the catalog.