# Target Product API (https://www.socialcrawl.dev/platforms/target/product)

> Returns full product detail for a Target item: title, brand, description, highlight bullets, current and regular price, average rating with its 1-5 star distribution, written-review count, the full image gallery, colour and size variations, and stock status. Prices are national: Target's product endpoint reports the same price whatever store is asked for, so treat this as catalogue pricing rather than shelf pricing. For this product's written reviews call GET /v1/target/reviews with the same TCIN.

TL;DR: `GET /v1/target/product` costs 5 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `tcin` | yes | Target catalogue id (TCIN), the numeric id at the end of a target.com product URL: target.com/p/<name>/-/A-92148487 is TCIN 92148487. Target rolls a colour or size variant up to its parent product, so the id returned by GET /v1/target/product can differ from the one you sent; the id you asked for is preserved at product.ext.requested_id. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/target/product?tcin=92148487" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What is a TCIN and where do I get one?

TCIN is Target's catalogue id, the number at the end of a product URL: target.com/p/<name>/-/A-92148487 is TCIN 92148487. It is the only required parameter on this endpoint.

### Does the response include the star rating breakdown?

Yes. ext.rating_distribution carries the count of 1, 2, 3, 4, and 5 star ratings, and the buckets sum to rating.count. It is the fastest way to get a rating profile: one call rather than paginating every review.

### Why does the returned id sometimes differ from the TCIN I sent?

Target rolls colour and size variants up to a parent product, so a variant TCIN returns the parent. The id field describes the payload you received, and ext.requested_id preserves the id you asked for. Each variant, with its own TCIN, is listed under variations.

### Can I get store-level or ZIP-level pricing?

No. Target's product surface returns the same price whatever store is requested, so we do not expose a store parameter rather than implying a localisation we cannot deliver. Prices are national catalogue prices in US dollars.

### What happens if the TCIN does not exist?

You get a 404 with the standard error envelope and the credit is refunded automatically. Malformed ids, for example a pasted URL, are rejected as a 400 before anything is deducted at all.

See the full Target API: https://www.socialcrawl.dev/platforms/target

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How do I get a Target product price with an API?
- What is a Target TCIN and how do I look it up?
- How to get the star rating breakdown for a Target product