# Target Product

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/target/product` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 2 credits per call |
| **Documentation** | https://www.piloterr.com/library/target-product |

## Description

Get a Target.com product page: price, description, images and variations via browser rendering.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/target/product' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### L'Oreal Magic Root Cover Up

```json
{
  "upc": "071249318553",
  "url": "https://www.target.com/p/l-oreal-paris-magic-root-cover-up-medium-brown-2-0oz/-/A-17457624",
  "dpci": "063-01-0615",
  "name": "L'Oreal Paris Magic Root Cover Up - Medium Brown - 2.0oz",
  "tcin": "17457624",
  "brand": "L'Oreal Paris",
  "price": 11.99,
  "images": [
    "https://target.scene7.com/is/image/Target/GUEST_2947578e-fc62-4731-a22a-42211a91cbe5"
  ],
  "rating": 4.02,
  "currency": "USD",
  "ornaments": [
    "Rarely returned",
    "Highly rated"
  ],
  "highlights": [
    "Conceals grays in seconds for flawless roots",
    "Lightweight formula, no smudging or sticky residue"
  ],
  "variations": [
    {
      "url": "https://www.target.com/p/l-oreal-paris-magic-root-cover-up-medium-brown-2-0oz/-/A-17457624",
      "name": "Color",
      "tcin": "17457624",
      "value": "Medium Brown",
      "selected": true
    },
    {
      "url": "https://www.target.com/p/l-oreal-paris-magic-root-cover-up-black-2-0oz/-/A-17457618",
      "name": "Color",
      "tcin": "17457618",
      "value": "Black",
      "selected": false
    }
  ],
  "breadcrumbs": [
    {
      "url": "https://www.target.com/",
      "name": "Target"
    },
    {
      "url": "https://www.target.com/c/beauty/-/N-55r1x",
      "name": "Beauty"
    }
  ],
  "description": "Temporary hair color spray to cover gray roots in seconds. Ammonia-free and sulfate-free.",
  "ingredients": null,
  "review_count": 7057,
  "bullet_descriptions": [
    "Hair Type: All Hair Types",
    "Product Form: Aerosol",
    "Beauty Purpose: Hair Coloring"
  ]
}
```

## Documentation

## Overview
Get a Target.com product page: name, brand, price, description, images, variations and more.

Pass a product URL (`/p/…/A-{tcin}`) or a bare TCIN. Prefer a short URL like `https://www.target.com/p/-/A-17457624` when the slug has special characters.

Browser rendering. Costs **2 credits** per call.

## Quickstart
```
GET https://api.piloterr.com/v2/target/product?query=17457624
GET https://api.piloterr.com/v2/target/product?query=https://www.target.com/p/-/A-17457624
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Product URL or TCIN |
| `return_page_source` | boolean | no | Return rendered HTML instead of JSON |

## Response fields
| Field | Type | Description |
|---|---|---|
| `tcin` / `name` / `brand` / `url` | string | Identity |
| `price` / `currency` | number / string | Price in USD when available |
| `rating` / `review_count` | number | Reviews when present |
| `dpci` / `upc` | string | Store identifiers when present |
| `description` | string | Long description |
| `highlights` / `bullet_descriptions` | string[] | Selling points and short specs |
| `images` | string[] | Image URLs |
| `variations` | array | Color/size options with TCIN |
| `breadcrumbs` / `ornaments` | array | Navigation and badges when present |

## Error codes
| Code | Meaning |
|---|---|
| `400` | Empty or invalid `query` |
| `404` | Product page not recognized |
| `500` | Rendering failed |

## Related endpoints
- [Target Search](https://www.piloterr.com/library/target-search)