> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Target Products API

> Target products with title, brand, URL, price and list price. Search by keyword or pass product URLs.

`POST /v1/data/target/products/run`

**Pricing:** $0.002 per product ($2.00 per 1,000).

## Ways to call it

* **Search Keywords**: set `queries` (optional: `maxResults`, `zipCode`)
* **Product URLs**: set `productUrls` (optional: `maxResults`, `zipCode`)

## Request

Send the inputs under `params`. Only the keys below are accepted; any other key returns `422 invalid_params`.

**queries** `string[]`

One or more search keywords. One request reads them all.

**productUrls** `string[]`

One or more product urls. One request reads them all.

Format e.g. `https://www.example.com`.

**maxResults** `integer` (default: 100)

How many products to return in total. Defaults to 100; use 0 for all.

**zipCode** `string`

Optional 5-digit US zip code, for example 10001. It picks the nearest Target store for pickup stock. Pickup Availability, Pickup Store ID, Pickup Store Name, Pickup Quantity and Scheduled Delivery Availability fill only when a zip code is given; prices stay Target's online prices either way.

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/target/products/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "queries": [
      "air fryer"
    ],
    "maxResults": 5
  }
}'
```

```python Python theme={null}
import os, requests

r = requests.post(
    "https://api.mindcase.co/v1/data/target/products/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "queries": [
        "air fryer"
    ],
    "maxResults": 5
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/target/products/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "queries": [
    "air fryer"
  ],
  "maxResults": 5
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

Each row in `data` is one product, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `tcin` | Tcin | text |
| `title` | Title | text |
| `brand` | Brand | text |
| `productUrl` | Product URL | url |
| `price` | Price | number |
| `currency` | Currency | text |
| `listPrice` | List Price | number |
| `priceLabel` | Price Label | text |
| `priceType` | Price Type | text |
| `unitPrice` | Unit Price | text |
| `unitPriceUnit` | Unit Price Unit | text |
| `promotions` | Promotions | object\_array |
| `rating` | Rating | rating |
| `ratingsCount` | Ratings Count | number |
| `ratingDistribution` | Rating Distribution | object |
| `availability` | Availability | text |
| `soldOut` | Sold Out | boolean |
| `outOfStockInAllStores` | Out Of Stock In All Stores | boolean |
| `pickupAvailability` | Pickup Availability | text |
| `pickupStoreId` | Pickup Store ID | text |
| `pickupStoreName` | Pickup Store Name | text |
| `pickupQuantity` | Pickup Quantity | number |
| `scheduledDeliveryAvailability` | Scheduled Delivery Availability | text |
| `shipsBy` | Ships By | date |
| `mainImage` | Main Image | image |
| `images` | Images | array |
| `dpci` | Dpci | text |
| `upc` | Upc | text |
| `itemType` | Item Type | text |
| `departmentId` | Department ID | text |
| `classId` | Class ID | text |
| `categoryId` | Category ID | text |
| `features` | Features | array |
| `specifications` | Specifications | array |
| `description` | Description | text |
| `searchTerm` | Search Term | text |
| `searchRank` | Search Rank | number |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "target/products",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "ratingDistribution": null,
      "departmentId": "72",
      "rating": 4.07,
      "priceType": "sale",
      "unitPriceUnit": null,
      "pickupQuantity": null,
      "shipsBy": "2026-11-12",
      "images": [
        "https://target.scene7.com/is/image/Target/GUEST_33d23cc1-0d51-43b8-9152-e1be3be14ed2",
        "https://target.scene7.com/is/image/Target/GUEST_108e9ed8-f026-493b-8e76-36b4811145e9"
      ],
      "pickupAvailability": null,
      "searchTerm": "air fryer",
      "categoryId": "ncrpx",
      "availability": "IN_STOCK",
      "brand": "Gourmia",
      "itemType": "Electric Fryers",
      "soldOut": false,
      "features": [
        "6-QT capacity can cook family staples and party favorites for a variety of crowds",
        "12 One-Touch Cooking Presets eliminate guesswork"
      ],
      "mainImage": "https://target.scene7.com/is/image/Target/GUEST_33d23cc1-0d51-43b8-9152-e1be3be14ed2",
      "priceLabel": "$44.99",
      "ratingsCount": 2311,
      "classId": "4",
      "description": null,
      "scheduledDeliveryAvailability": null,
      "outOfStockInAllStores": false,
      "tcin": "89110863",
      "unitPrice": null
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.