# Target — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search for products across Target's catalog and instantly check real-time in-store availability at nearby Target locations using your zipcode. Find exactly what you're looking for and discover which stores have it in stock, so you can shop smarter and faster.

**Category:** E-commerce | **Website:** [target.com/](https://target.com/) | **Docs:** [parse.bot/marketplace/4596043a-f154-4cf4-b5cd-822ec6d860ae/target-com-api](https://parse.bot/marketplace/4596043a-f154-4cf4-b5cd-822ec6d860ae/target-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/target/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Check store availability

Check real-time in-store availability for a specific product at Target stores near a given ZIP code. Returns shipping status and per-store pickup availability, stock quantities, estimated pickup dates, in-store pricing, and geographic coordinates for up to 5 nearby stores. Requires a TCIN (Target product ID) obtainable from search_products.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `tcin` | string | Yes | Target product ID (TCIN) - obtain from search_products results[*].tcin |
| `zip` | string | No | 5-digit US ZIP code to find nearby Target stores |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/target/check-store-availability \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"tcin":"<string>","zip":"<string>"}'
```

### Get popular skus

Retrieves popular Target product SKUs sorted by bestselling rank. Returns a batch of top-selling products across all categories with pricing, rating, and brand metadata. No keyword or category filter; the endpoint always returns the same broad bestseller list for the given ZIP's local pricing. The number of products returned is controlled by max_products (default 1000, max 10000). Useful for market research, catalog seeding, or monitoring popular products.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `max_products` | integer | No | Maximum number of popular SKUs to retrieve (1-10000) |
| `zip` | string | No | 5-digit US ZIP code for local pricing context |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/target/get-popular-skus \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"max_products":"<integer>","zip":"<string>"}'
```

### Get product

Retrieve full product page details for a specific Target product by TCIN (Target product ID). Returns comprehensive information including title, brand, full description, feature highlights, product images, pricing, ratings, item type, and detailed specifications. The TCIN can be obtained from search_products results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `tcin` | string | Yes | Target product ID (TCIN) - obtain from search_products results[*].tcin |
| `zip` | string | No | 5-digit US ZIP code for local pricing context |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/target/get-product \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"tcin":"<string>","zip":"<string>"}'
```

### Get random skus

Retrieves a set of random unique valid Target product SKUs by sampling across multiple product categories (Electronics, Home, Baby, Grocery, Furniture, etc.) with randomized sort orders and page offsets. Each invocation produces a different set of products. Returns up to max_products unique items (default 10,000) with pricing, rating, and brand metadata. Useful for broad catalog sampling, testing, or building diverse product datasets.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `max_products` | integer | No | Maximum number of random unique SKUs to retrieve (1-50000). Default 10,000. |
| `zip` | string | No | 5-digit US ZIP code for local pricing context |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/target/get-random-skus \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"max_products":"<integer>","zip":"<string>"}'
```

### Get registries

Search for Target gift registries and wish lists by registrant name, returning registry links with their items. Each returned registry is guaranteed to have at least 3 items that are currently in stock and buyable online. Results include full item details (price, availability, ratings) for each registry's in-stock items. Useful for finding gift-giving opportunities with items that can be purchased immediately.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `count` | integer | No | Maximum number of qualified registries to return (1-50). Only registries with at least 3 in-stock items are counted. |
| `first_name` | string | No | First name of the registrant to search for |
| `last_name` | string | No | Last name of the registrant to search for |
| `registry_type` | string | No | Type of registry to search for. Accepted values: BABY, WEDDING, WISHLIST |
| `zip` | string | No | 5-digit US ZIP code for store/pricing context |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/target/get-registries \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"count":"<integer>","first_name":"<string>","last_name":"<string>","registry_type":"<string>","zip":"<string>"}'
```

### Search products

Full-text search over Target.com product catalog by keyword. Returns paginated product listings with pricing, ratings, brand, and availability metadata. Server-side sort controls result ordering. Pagination uses offset-based addressing where each page holds up to `count` items. An optional client-side title filter narrows results to products whose title contains the given substring (case-insensitive).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `count` | integer | No | Number of results per page (max 24) |
| `keyword` | string | Yes | Search keyword (e.g. 'airpods', 'nintendo switch') |
| `offset` | integer | No | Offset for pagination (0-based) |
| `sort_by` | string | No | Sort order for results |
| `title` | string | No | Optional substring filter on product titles (case-insensitive). When provided, only products whose title contains this string are returned. |
| `zip` | string | No | 5-digit US ZIP code for local pricing and store availability |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/target/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"count":"<integer>","keyword":"<string>","offset":"<integer>","sort_by":"<string>","title":"<string>","zip":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.