Common

4min

Common Parameters
﻿GET  /request
The following parameters are used to configure your request to the Target Product Data API. They should be appended as querystring parameters to a  GET HTTP request to the  /request  endpoint.
For example, to request search results, for the search term  highlighter pens  sorted by  best_seller  the request would be:
HTTP
Curl
Node.js
Python
PHP
https://api.redcircleapi.com/request?api_key=demo&type=search&search_term=highlighter+pens&sort_by=best_seller
https://api.redcircleapi.com/request?api_key=demo&type=search&search_term=highlighter+pens&sort_by=best_seller
﻿
Request-Specific Parameters
Additional parameters are available depending on the type of request being made (as-determined by the  type  parameter). For example, if you make a request with  type=product  then additional Product Parameters, specific to  product  requests, are available.
﻿
Common Parameters
The following common parameters are required for all requests to the Target Product Data API.
Parameter
Required
Description
api_key
required
The API key for your RedCircle API account.
type
required
The type of Target data to retrieve. The value of the type parameter determines which additional parameters are available. For example, if you make a request with type=search then additional Search Parameters , specific to search requests, are available.  
Valid values for type are:
search
Request search results for a search_term or Target search results page url . See additional Search Parameters .
﻿
category
Request category-listing results for a category_id or Target search results page url . See additional Category Parameters .
﻿
product
Request data from a Target product page via a Target tcin (item ID) or Target product page url . See additional Product Parameters .
﻿
reviews
Request customer reviews for a Target tcin (item ID) or Target product page url . See additional Reviews Parameters .
﻿
store_stock 
Request in-store stock data for a given tcin for Target stores in the vicinity of the given zipcode. See additional Store Stock Parameters .
customer_zipcode
optional
Determines the zipcode or postal code location that RedCircle uses when retrieving pages. Results will be retrieved from the Target Store nearest to the supplied customer_zipcode .
output
optional
Determines the format in which results are returned. Can be set to json (default) to get the results as structured JSON, or csv to return the results in CSV format. When using csv you can also use the csv_fields parameter to specify which fields to return in the CSV.
csv_fields
optional
Determines the fields that are returned when returning in csv mode (i.e. when the output parameter is set to csv ). Should be specified as a comma seperated list of fields (in nested field, dot notation, format). For more information on the csv_fields parameter please see the CSV Fields Reference .
include_fields
optional
A comma-seperated list JSON field names to include in the JSON object the API returns. You can specify the field names in dot notation - i.e. include_fields=pagination will only include the the pagination property in the response JSON. Use include_fields if you only want to include specific fields in the API's JSON response.
exclude_fields
optional
A comma-seperated list of JSON field names to exclude from the JSON object the API returns. You can specify the field names in dot notation - i.e. exclude_fields=pagination will remove the pagination property from the response JSON. Use exclude_fields if there are specific fields you wish to exclude from the API's JSON response.
﻿
Next Steps
     Search Parameters
     Category Parameters
     Product Parameters
     Reviews Parameters
     Store Stock Parameters﻿

Parameter	Required	Description
api_key	required	The API key for your RedCircle API account.
type	required	The type of Target data to retrieve. The value of the type parameter determines which additional parameters are available. For example, if you make a request with type=search then additional Search Parameters , specific to search requests, are available. Valid values for type are: search Request search results for a search_term or Target search results page url . See additional Search Parameters . category Request category-listing results for a category_id or Target search results page url . See additional Category Parameters . product Request data from a Target product page via a Target tcin (item ID) or Target product page url . See additional Product Parameters . reviews Request customer reviews for a Target tcin (item ID) or Target product page url . See additional Reviews Parameters . store_stock Request in-store stock data for a given tcin for Target stores in the vicinity of the given zipcode. See additional Store Stock Parameters .
customer_zipcode	optional	Determines the zipcode or postal code location that RedCircle uses when retrieving pages. Results will be retrieved from the Target Store nearest to the supplied customer_zipcode .
output	optional	Determines the format in which results are returned. Can be set to json (default) to get the results as structured JSON, or csv to return the results in CSV format. When using csv you can also use the csv_fields parameter to specify which fields to return in the CSV.
csv_fields	optional	Determines the fields that are returned when returning in csv mode (i.e. when the output parameter is set to csv ). Should be specified as a comma seperated list of fields (in nested field, dot notation, format). For more information on the csv_fields parameter please see the CSV Fields Reference .
include_fields	optional	A comma-seperated list JSON field names to include in the JSON object the API returns. You can specify the field names in dot notation - i.e. include_fields=pagination will only include the the pagination property in the response JSON. Use include_fields if you only want to include specific fields in the API's JSON response.
exclude_fields	optional	A comma-seperated list of JSON field names to exclude from the JSON object the API returns. You can specify the field names in dot notation - i.e. exclude_fields=pagination will remove the pagination property from the response JSON. Use exclude_fields if there are specific fields you wish to exclude from the API's JSON response.

Updated 08 Aug 2024

Did this page help you?

Pagination