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

> Returns products listed in a Target category, 24 per page, each with title, brand, price, regular price, rating, image gallery, highlight bullets, and its TCIN. Unlike the product endpoint this one paginates properly, so it is the way to walk a whole category: pass the returned cursor back until has_more is false. Because Target ships no keyword search worth billing for, this plus GET /v1/target/categories is how you discover TCINs. Ratings are present on roughly half of category rows and are null on the rest, which reflects Target's own data rather than an omission here.

TL;DR: `GET /v1/target/category` 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 |
| --- | --- | --- |
| `category_id` | yes | Target category node id, for example hz89j for Kitchen & Dining. Ids come from GET /v1/target/categories, and also appear in the category URLs on target.com (/c/<name>/-/N-<id>). |
| `page` | no | Page number, starting at 1. Prefer the universal cursor parameter. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/target/category?category_id=hz89j" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### Where do I get a Target category id?

From GET /v1/target/categories, which lists the whole browse taxonomy with each node's id. Category ids also appear in target.com category URLs as the segment after N- (for example /c/kitchen-dining/-/N-hz89j gives hz89j).

### How many products come back per page?

Twenty-four, fixed by Target. Pass the returned cursor back until has_more is false to walk the whole category. Consecutive pages do not repeat a product, so a full crawl needs no de-duplication.

### Does this endpoint return real prices?

Yes. Every measured row carried a real current price and regular price, which makes this the right endpoint for price monitoring across a product set. Ratings are thinner: roughly half of category rows carry one and the rest return null, which reflects Target's own data.

### Can I filter a category by price or brand?

Not on this endpoint. Target's category surface accepts a category and a page and nothing else, so filtering happens in your code after the rows arrive. Every row carries brand and price, so filtering client-side is cheap.

### Why use this instead of keyword search?

Because there is no Target keyword search worth billing for. Target's search surface caps at 24 results, ignores paging, and returns unrelated products for a query that matches nothing, so we do not ship it. Browsing a category is the reliable path from nothing to a set of TCINs.

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 to list all products in a Target category with an API
- How do I find a Target category id?
- Does the Target API return real prices for category listings?