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

> Target API: 5 endpoints covering full product detail and customer reviews, keyed by TCIN. Every product returns price, the complete 1-5 star breakdown, image gallery, colour and size variations, and both the ratings count and the written-review count as separate honest numbers. Review pages never repeat a row. Same canonical shapes as our Amazon, Walmart, and Google Shopping endpoints.

TL;DR: SocialCrawl's Target API exposes 5 endpoints, 1 to 5 credits per call, all returning one unified JSON schema with AI-enriched fields. Single x-api-key auth, 100 free credits on signup.

## Endpoints

| Endpoint | Method | Path | Credits | Description |
| --- | --- | --- | --- | --- |
| Product | GET | `/v1/target/product` | 5 | Get a Target product by TCIN |
| Reviews | GET | `/v1/target/reviews` | 5 | Get Target product reviews |
| Category | GET | `/v1/target/category` | 5 | Browse Target products in a category |
| Categories | GET | `/v1/target/categories` | 1 | List the Target category taxonomy |
| Stores | GET | `/v1/target/stores` | 1 | Find Target stores near a location |

## Code example

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

Every response shares one JSON envelope: `{ success, platform, endpoint, data, credits_used, credits_remaining }`.

## SocialCrawl vs DIY Target.com scraping

| Feature | SocialCrawl | DIY Target.com scraping |
| --- | --- | --- |
| Setup | One GET with an API key | Headless browser, proxy pool, and a parser for Target's GraphQL payload |
| Product payload | Clean canonical JSON, roughly 3 KB | 100 KB of raw GraphQL you filter yourself |
| Review pagination | Cursor that terminates exactly at the last page | Manual page walking with your own duplicate detection |
| Blocked requests | Retried upstream, and never billed if they fail | Your problem, and your cost |
| Cross-retailer parsing | Same shapes as Amazon, Walmart, and Google Shopping | One bespoke parser per retailer |

## FAQ

### What data can I get from the SocialCrawl Target API?

Full product detail (title, brand, description, highlight bullets, current and regular price, average rating with its complete 1-5 star distribution, written-review count, image gallery, colour and size variations, and stock status) plus written customer reviews with text, rating, reviewer nickname, date, helpful votes, verified-purchase flag, and photos.

### Where do I find a Target TCIN?

It is the number at the end of any Target product URL. In target.com/p/beats-solo-buds-true-wireless-bluetooth-earbuds/-/A-92148487 the TCIN is 92148487. Pass it as the tcin parameter to either endpoint. Malformed ids are rejected before any credit is deducted.

### Is there a Target keyword search endpoint?

No, and that is deliberate. Target's search surface returns at most 24 products, ignores the page parameter, and answers a query that matches nothing with 24 unrelated products, so there is no way to tell a real result from a miss. Shipping it would mean billing you for rows you did not ask for. Bring a TCIN, or use our universal search across sources.

### Why did I get back a different TCIN than the one I sent?

Target rolls colour and size variants up to a parent product. Ask for a variant and you get the parent, whose payload describes the whole family. The id field always describes the payload you received, and ext.requested_id carries the id you asked for whenever the two differ, so nothing is lost.

### How many reviews come back per call, and do pages overlap?

Ten per page, fixed by Target and not raisable. Pages never repeat a row and the review total is exact, so a full crawl is deterministic: pass the returned cursor back until has_more is false. If you only want the star breakdown, read ext.rating_distribution from the product endpoint instead, which is one call rather than one per ten reviews.

### Why are the rating count and the review count different numbers?

They are different populations. The rating count is everyone who left a star rating; the review count is everyone who wrote review text, and it is the same population the reviews endpoint paginates over. On a typical product the first is two to three times the second. Both come straight from Target, and neither is an estimate.

### Does Target pricing vary by store?

Not on this endpoint. Target's product surface reports the same price whatever store is queried, so we do not offer a store or ZIP parameter here and you should treat the price as national catalogue pricing. Walmart genuinely does vary by store, and our Walmart endpoints accept ZIP, state, and store id for exactly that reason.

## 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:

- What is the SocialCrawl Target API?
- How to get Target.com product prices and reviews with an API
- Does the Target API support keyword search?
- Compare SocialCrawl vs Target scrapers for retail price monitoring