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

# Direct retailer links

> Create Amazon, Kroger, Target, and Walmart cart or product links

The API can build several retailer destinations directly from native product IDs. Incarts stores
the final destination behind the tracked `shortLink`; it is not exposed in the public response.

| Retailer | Intent           | Product identifier | Product count | Required scope      |
| -------- | ---------------- | ------------------ | ------------- | ------------------- |
| Amazon   | `product_detail` | ASIN               | Exactly 1     | `retailers:amazon`  |
| Amazon   | `add_to_cart`    | ASIN               | 1–100         | `retailers:amazon`  |
| Kroger   | `product_detail` | Kroger product ID  | Exactly 1     | `retailers:kroger`  |
| Target   | `add_to_cart`    | TCIN               | 1–100         | `retailers:target`  |
| Walmart  | `product_detail` | Walmart item ID    | Exactly 1     | `retailers:walmart` |

Each product accepts `quantity` from 1–999. If you omit it, the API applies the documented default
of `1` before destination generation and persistence.

## Product detail example

Change `retailer`, the native product ID, and the retailer scope on your API key for Amazon, Kroger,
or Walmart product pages.

```json theme={null}
{
  "projectId": "proj_123",
  "name": "Amazon product page",
  "retailer": "amazon",
  "intent": "product_detail",
  "products": [{ "retailerProductId": "B08N5WRWNW", "quantity": 1 }]
}
```

## Add-to-cart examples

Amazon carts use ASINs:

```json theme={null}
{
  "projectId": "proj_123",
  "name": "Amazon campaign cart",
  "retailer": "amazon",
  "intent": "add_to_cart",
  "products": [
    { "retailerProductId": "B08N5WRWNW", "quantity": 2 },
    { "retailerProductId": "B09G9FPHY6", "quantity": 1 }
  ]
}
```

Target carts use TCINs:

```json theme={null}
{
  "projectId": "proj_123",
  "name": "Target campaign cart",
  "retailer": "target",
  "intent": "add_to_cart",
  "products": [
    { "retailerProductId": "78025470", "quantity": 2 },
    { "retailerProductId": "54551601", "quantity": 1 }
  ]
}
```

<Card title="Create link endpoint" icon="terminal" href="/api-reference/endpoint/create-link">
  Open the full schema, examples, and response codes.
</Card>