Core APIs
...
Parameters
Core Requests
Product
4min
product parameters get 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 https //www target com/p/sharpie 4pk highlighters pocket style chisel tip multicolor/ /a 78025470 for a single product on target 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 http https //api redcircleapi com/request?api key=demo\&type=product\&tcin=78025470curl l get https //api redcircleapi com/request \\ d api key="demo" \\ d type="product" \\ d tcin="78025470"const axios = require('axios'); // set up the request parameters const params = { api key "demo", type "product", tcin "78025470" } // make the http get request to redcircle api axios get('https //api redcircleapi com/request', { params }) then(response => { // print the json response from redcircle api console log(json stringify(response data, 0, 2)); }) catch(error => { // catch and print the error console log(error); })import requests import json \# set up the request parameters params = { 'api key' 'demo', 'type' 'product', 'tcin' '78025470' } \# make the http get request to redcircle api api result = requests get('https //api redcircleapi com/request', params) \# print the json response from redcircle api print(json dumps(api result json()))\<?php \# set up the request parameters $querystring = http build query(\[ 'api key' => 'demo', 'type' => 'product', 'tcin' => '78025470' ]); \# make the http get request to redcircle api $ch = curl init(sprintf('%s?%s', 'https //api redcircleapi com/request', $querystring)); curl setopt($ch, curlopt returntransfer, true); curl setopt($ch, curlopt followlocation, true); \# the following options are required if you're using an outdated openssl version \# more details https //www openssl org/blog/blog/2021/09/13/letsencryptrootcertexpire/ curl setopt($ch, curlopt ssl verifyhost, false); curl setopt($ch, curlopt ssl verifypeer, false); curl setopt($ch, curlopt timeout, 180); $api result = curl exec($ch); curl close($ch); \# print the json response from redcircle api echo $api result; ?> 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 https //docs trajectdata com/redcircleapi/target product data api/results/product