Target API endpoint
Returns product details for one Target item, including product content, images, price, rating, category, and availability flags for the selected store.
/target/productReturns details for one product. tcin is the required numeric Target item ID. store_id selects the store used for price and availability fields and defaults to 2885. Look up real store IDs near a location with /target/stores.
The response includes product identity, content, images, price, rating, category breadcrumbs, specifications, and availability flags when those fields are present for the selected item and store.
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| tcin | string | Yes | Numeric Target item id (TCIN) | 12954151 | |
| store_id | integer | No | Target store id used for pricing and availability Minimum: 1. | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/target/product?tcin=12954151" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"store_id": 2885,
"product": {
"tcin": "12954151",
"parent_tcin": "89169599",
"title": "Starbucks Pike Place Roast Medium Ground Coffee - 12oz",
"brand": "Starbucks",
"price": {
"current": 12.79,
"formatted": "$12.79",
"store_id": 2885
},
"rating": {
"average": 4.51,
"rating_count": 1586,
"review_count": 1076
},
"category": "Ground Coffee",
"availability": {
"shipping": true,
"primary_store": true,
"sold_out": false
}
}
}
}Request schema
No body schema
Response schema
#/definitions/target.productResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | target.ProductResponse | No | ||||
| data.fetched_at | string | No | ||||
| data.product | target.Product | No | ||||
| data.product.availability | target.Availability | No | ||||
| data.product.availability.backup_store | boolean | No | ||||
| data.product.availability.primary_store | boolean | No | ||||
| data.product.availability.scheduled_delivery | boolean | No | ||||
| data.product.availability.shipping | boolean | No | ||||
| data.product.availability.sold_out | boolean | No | ||||
| data.product.brand | string | No | Starbucks | |||
| data.product.breadcrumbs | array | No | ||||
| data.product.breadcrumbs[].id | string | No | 4yi5p | |||
| data.product.breadcrumbs[].name | string | No | Coffee | |||
| data.product.breadcrumbs[].url | string | No | ||||
| data.product.bullets | array | No | ||||
| data.product.category | string | No | Ground Coffee | |||
| data.product.category_id | string | No | x2hqv | |||
| data.product.description | string | No | ||||
| data.product.dpci | string | No | 231-10-1932 | |||
| data.product.images | array | No | ||||
| data.product.item_type | string | No | Coffee | |||
| data.product.parent_category_id | string | No | 4yi5p | |||
| data.product.parent_tcin | string | No | 89169599 | |||
| data.product.price | target.Price | No | Price record, 5 fields: current, formatted, regular, store_id, unit_formatted. Described under Search Target products API. | |||
| data.product.primary_image_url | string | No | ||||
| data.product.rating | target.Rating | No | ||||
| data.product.rating.average | number | No | 4.51 | |||
| data.product.rating.rating_count | integer | No | 1586 | |||
| data.product.rating.review_count | integer | No | 1076 | |||
| data.product.specifications | array | No | ||||
| data.product.tcin | string | No | 12954151 | |||
| data.product.title | string | No | Starbucks Pike Place Roast Medium Ground Coffee - 12oz | |||
| data.product.url | string | No | ||||
| data.source_url | string | No | ||||
| data.store_id | integer | No | 2885 | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/target/product?tcin=12954151" \
-H "x-api-key: $CRAWLORA_API_KEY"