# Target Product Details API Documentation

<p><strong>Target Product Details API Documentation</strong> Get the details of one Target product by tcin or product url. The answer has the title, brand, UPC, DPCI, description, highlights, spec lines, dimensions, images, videos, price, regular price, save percent, promotions, rating summary with the star split and recommended percent, category path, return policy, purchase limit and the variants. Each variant has its tcin, url, image and attributes such as Color and Size. Send store_id or zip to price the product for a store. Add include_fulfillment=true with a zip to get shipping options, pickup times and store stock in a second lookup. If that block is not available, fulfillment is null, fulfillment_status is unavailable and it is not charged. An unknown tcin answers 404. Cost: 1 credit, 2 credits for a product with more than 12 variants, plus 1 credit for a returned fulfillment block. An unknown tcin and every error cost nothing. A call takes 3 to 12 seconds.</p>

- **Documentation:** [https://scrappa.co/docs/target-api/target_product](https://scrappa.co/docs/target-api/target_product)
- **API group:** Target API
- **Endpoint:** `GET https://scrappa.co/api/target/product`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `tcin` | string | Yes | Target item number, 5 to 10 digits, e.g. 92538311. Send tcin or url. |
| `url` | string | No | Url of a Target product page. The tcin is read from the part after A-. Use it instead of tcin. |
| `store_id` | string | No | Store number from the stores endpoint, e.g. 1375. Store 3991 is not accepted. |
| `zip` | string | No | 5-digit US ZIP code. Without store_id, the nearest store of the ZIP is used. Required with include_fulfillment. |
| `include_fulfillment` | boolean | No | true to add shipping, pickup and store stock. Needs a zip. Costs 1 more credit, only when the block is returned. Default: false. |

## Example response

```json
{
    "data": {
        "upc": "673419407120",
        "url": "https://www.target.com/p/example/-/A-92538311",
        "dpci": "204-00-3429",
        "tcin": "92538311",
        "brand": "Example",
        "price": {
            "current": 24.99,
            "regular": 29.99,
            "is_on_sale": true,
            "price_note": null,
            "current_max": null,
            "current_min": null,
            "save_amount": 5,
            "save_percent": 17,
            "comparison_type": "reg",
            "formatted_current": "$24.99",
            "formatted_regular": "$29.99"
        },
        "specs": [
            {
                "label": "Number of Pieces",
                "value": "153"
            },
            {
                "label": "Suggested Age",
                "value": "7 Years and Up"
            }
        ],
        "title": "Example Building Set",
        "images": {
            "primary": "https://target.scene7.com/is/image/Target/GUEST_example-primary",
            "alternates": [
                "https://target.scene7.com/is/image/Target/GUEST_example-alt"
            ]
        },
        "rating": {
            "count": 249,
            "average": 4.85,
            "secondary": [
                {
                    "label": "quality",
                    "value": 4.82
                }
            ],
            "distribution": {
                "1": 3,
                "2": 1,
                "3": 5,
                "4": 13,
                "5": 227
            },
            "review_count": 71,
            "recommended_percent": 94
        },
        "videos": [],
        "category": {
            "id": "5e002",
            "name": "Building Sets"
        },
        "store_id": "1375",
        "variants": [],
        "item_type": "Building Sets",
        "dimensions": {
            "unit": "INCH",
            "depth": 6.1,
            "width": 5.66,
            "height": 1.85,
            "weight": 0.35,
            "weight_unit": "POUND"
        },
        "highlights": [
            "3 animals in 1 box"
        ],
        "promotions": [],
        "breadcrumbs": [
            {
                "id": "5xtb0",
                "url": "/c/toys-games/-/N-5xtb0",
                "name": "Toys & Games"
            }
        ],
        "description": "Boys and girls ages 7 and up build three animals with one set.",
        "fulfillment": {
            "fees": {
                "same_day_delivery": 7.99,
                "scheduled_delivery": 9.99
            },
            "stores": [
                {
                    "name": "Mpls Nicollet Mall",
                    "role": "PRIMARY",
                    "address": "900 Nicollet Mall, Minneapolis, Minnesota, 55403-2530",
                    "quantity": 5,
                    "store_id": "1375",
                    "pickup_date": "2026-11-03",
                    "pickup_status": "IN_STOCK",
                    "in_store_status": "IN_STOCK",
                    "pickup_ready_minutes": 120
                }
            ],
            "shipping": {
                "status": "IN_STOCK",
                "quantity": 10,
                "services": [
                    {
                        "method": "Standard",
                        "order_by": "2026-11-04T19:00:00Z",
                        "is_two_day": true,
                        "description": "2-day shipping",
                        "max_delivery_date": "2026-11-05",
                        "min_delivery_date": "2026-11-05"
                    }
                ],
                "loyalty_status": "IN_STOCK"
            },
            "sold_out": false,
            "out_of_stock_in_all_stores": false
        },
        "is_hazardous": false,
        "product_type": "TOYS",
        "free_shipping": false,
        "return_policy": {
            "url": null,
            "days": [
                {
                    "days": 90,
                    "guest_type": "regular_guest"
                }
            ],
            "message": "This item can be returned to any Target store or Target.com."
        },
        "purchase_limit": 3,
        "variation_axes": [],
        "fulfillment_status": "available"
    },
    "meta": {
        "credits": 2,
        "billable": true,
        "duration_ms": 6800,
        "endpoint_family": "product"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required query parameter is missing or invalid. This response is not billable. |
| 404 | Product Not Found | Target has no product with this tcin. This response is not billable. |
| 503 | Service Unavailable | Target could not be reached or refused the request. This response is not billable. Retry later. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)