Product

4 min

Product Parameters

GET /request

The Product Parameters are applicable when making a request with type=product to retrieve details of a single product on Target - the product is specified using either the tcin , dpci or url parameter (where the url parameter contains a link to an Target product page). The parameters should be appended as querystring parameters to the Target Product Data API GET HTTP request.

Product details are retrieved from the product page for a single product on Target.

Product Page

Lookup an ASIN by GTIN / ISBN / UPC / EAN RedCircle API can automatically convert GTIN/ISBN/UPC/EAN codes to TCINs and return product data. For details of how to lookup RedCircle product details by GTIN/ISBN/UPC/EAN please see refer to the guide.

Note that RedCircle will cache the GTIN-to-TCIN mapping for 2 months. To force a new GTIN lookup (for example, if you suspect the existing mapping is stale), use the skip_gtin_cache=true request parameter (note that using skip_gtin_cache=true decrements 2 credits from your balance, instead of 1).

For example, to request details a product with tcin=78025470 the request would be:

https://api.redcircleapi.com/request?api_key=demo&type=product&tcin=78025470

Product Parameters

The following parameters are available for all requests made when type=product .

Parameter	Required	Description
tcin	optional	The Target TCIN (item ID) to retrieve product details for.
dpci	optional	The DPCI code to look up a matching product on Target for. DPCI-based requests work by searching for the DPCI on Target first, then retrieving the product details for the first matching tcin .
gtin	optional	The GTIN/ISBN/UPC code to look up a matching product on Target for. If the gtin parameter is supplied then the tcin and dpci parameters are ignored. GTIN-based requests work by searching for the GTIN/ISBN/UPC on Target first, then retrieving the product details for the first matching tcin .
url	optional	The Target product-page URL to retrieve product details from. Note : If the url parameter is supplied then the tcin , dpci and gtin parameters are ignored (the url overrides other parameters).

Next Steps Product Results