Core APIs
Target Product Data API

Getting Started

7min

Getting Started

RedCircle API is an API to retrieve public-domain data from Target in real-time. You can use RedCircle API to retrieve products, reviews, search results and category listings from Target.

RedCircle API returns clean, structured JSON or CSV results. You can achieve fine-grained control over your request using the request parameters.



Retrieving Search Results for Products on Target

GET /request

Getting search result Target data with RedCircle API is as simple as making an HTTP GET request to the request endpoint. The only required parameters are api_key (sign up for free to get an API key) and type (which defines the type of Target data you'd like to retrieve).

For example, to retrieve search results ( type=search ) for the search term highlighter pens , ordered by best selling products ( sort_by=best_seller ) the RedCircle API request would be:

HTTP
Curl
Node.js
Python
PHP


To view RedCircle API JSON results clearly in your browser we recommend these extensions for Chrome and Firefox

The search results are shown below within the search_results array. For full documentation on the search results response see the Search Results docs.

JSON
{
"request_info":{...}
"request_metadata":{...}
"request_parameters":{...}
"search_results":[...]
"related_queries":[...]
"pagination":{...}
"categories":[...]
"facets":[...]
}


Response Times & Concurrency RedCircle API gathers data in real-time and will typically return a result in 1-6 seconds. Please inspect the HTTP Response Code and update your app accordingly.

If you need to run large volumes of requests consider using the Collections API. Collections allow you to enqueue up to 15,000 requests, run them manually or on a schedule and execute them concurrently on RedCircle API's infrastructure.



Getting Data for an Individual Product

GET /request

Lets say we want to change our query to request a different type of data - information on a specific product, in this case the product with Target TCIN 78025470 . Here's the RedCircle API request to achieve that:

HTTP
Curl
Node.js
Python
PHP


The result of the Product request is shown below. For full documentation on Product results see the Product Results docs.

JSON
{
"request_info":{...}
"request_parameters":{...}
"request_metadata":{...}
"product":{...}
}



Next Steps      Searching for Products on Target      Retrieving Customer Reviews

Updated 08 Aug 2024
Did this page help you?
PREVIOUS
Overview
NEXT
Pagination
Docs powered by Archbee