# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-target-com-api-4596043a/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-target-com-api-4596043a/check_store_availability \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-target-com-api-4596043a/get_popular_skus \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-target-com-api-4596043a/get_product \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-target-com-api-4596043a/get_random_skus \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-target-com-api-4596043a/get_registries \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-target-com-api-4596043a/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"count":"<integer>","keyword":"<string>","offset":"<integer>","sort_by":"<string>","title":"<string>","zip":"<string>"}'
```