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

> Returns Target stores near a ZIP code, city, or state, each with its store id, name, full address, phone number, distance from the searched location, open/closed status, timezone, and two weeks of daily opening hours. Store data changes rarely, so it is 1 credit and heavily cached. Note that Target's product pricing is national on this API, so a store id here is for store-locator use rather than for localising prices.

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

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Location to search near: a ZIP code (10001), a city (Austin), or a state. Both ZIP and city forms are verified. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/target/stores?query=10001" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What can I search by?

A ZIP code, a city name, or a state. Both the ZIP form (10001) and the city form (Austin) are verified against the live API and each returns around twenty nearby stores.

### What comes back for each store?

Store id, name, full composed address, phone number, distance from the searched location, open or closed status, IANA timezone, and two weeks of daily opening hours with open and close times per day.

### Are store coordinates included?

No. Target publishes no latitude or longitude on this surface, so those fields are null rather than guessed. Geocode the returned address if you need coordinates.

### Can I use a store id to get store-level prices?

Not on this API. Target's product endpoints return the same national price whatever store is requested, which we verified across two separate captures, so a store id here is for locator use rather than for localising prices.

### Why is this only 1 credit?

Store data barely changes, so responses cache at a very high hit ratio and the effective cost per billed call is close to zero. Pricing it like a live product lookup would not be honest.

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 find Target stores near a ZIP code with an API
- Does the Target API return store opening hours?