# SocialCrawl API — target endpoints
# Base URL: https://www.socialcrawl.dev
# Auth: x-api-key header
# Full docs: https://www.socialcrawl.dev/docs/target

## GET /v1/target/product
Get a Target product by TCIN
Credit cost: 5 (advanced)
Parameters:
- tcin (required) — 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.
curl "https://www.socialcrawl.dev/v1/target/product?tcin=92148487" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/target/reviews
Get Target product reviews
Credit cost: 5 (advanced)
Parameters:
- tcin (required) — 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.
- page (optional, integer) — Page number, starting at 1. Prefer the universal cursor parameter.
curl "https://www.socialcrawl.dev/v1/target/reviews?tcin=92146817" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/target/category
Browse Target products in a category
Credit cost: 5 (advanced)
Parameters:
- category_id (required) — 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 (optional, integer) — Page number, starting at 1. Prefer the universal cursor parameter.
curl "https://www.socialcrawl.dev/v1/target/category?category_id=hz89j" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/target/categories
List the Target category taxonomy
Credit cost: 1 (standard)
curl "https://www.socialcrawl.dev/v1/target/categories" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/target/stores
Find Target stores near a location
Credit cost: 1 (standard)
Parameters:
- query (required) — Location to search near: a ZIP code (10001), a city (Austin), or a state. Both ZIP and city forms are verified.
curl "https://www.socialcrawl.dev/v1/target/stores?query=10001" \
  -H "x-api-key: sc_your_api_key_here"