RedCircle

DATA · DATA & ANALYTICS

Target product details, search, reviews, and in-store stock on their own key.

Connecting RedCircle in practice

RedCircle reads Target in real time, so when its parsers break it answers 503 with a message and a retry_after rather than returning partial data, and it does not charge for that request. Bulk work has to go through Collections, which cap at 15,000 requests each — or 100 when include_html=true — and whose Result Sets are downloadable for only 14 days.

Scopes that draw scrutiny

api_key (query parameter) The only credential, passed as ?api_key= on every call including /account, so it lands in any log that records URLs. It spends the account’s monthly request credits.

Rate limits

Requests are metered as monthly credits against the plan; GET /account reports the number used in the current month and is not itself charged.
402 Payment Required when credits are exhausted or a payment has failed; 429 when a plan-level or endpoint-level rate limit is hit.
Concurrently running Collections: 5 for Collections of up to 250 requests, 1 for Collections over 250 requests.
Requests added per API call: 1,000, up to the 15,000 per Collection; 15,000 per bulk CSV upload.

Worth knowing

Collections that have not been started for over 2 months are deleted automatically, and Result Sets expire 14 days after they are produced.
Automatic pagination multiplies the count: with max_page=10 a Collection holds 1,500 requests rather than 15,000, and max_page itself caps at 100.
Passing skip_on_incident makes a request fail cleanly during a parsing incident instead of returning data RedCircle considers unstable — the safer default for an unattended agent.
Collections per account cap at 10,000, so a workflow that creates one Collection per job needs to delete as it goes.

Checked against Collection limits (2026-09-29), Response codes (2026-09-29), Getting started (2026-09-29), Account API (2026-09-29)

Acts as the person, not as itself

Each user connects their own account. Every call carries both identities — the agent and the person it is acting for — so the agent can never reach past what that individual can already do.

Credentials never touch the agent

Tokens live in the vault and attach server-side at call time. The agent holds a session, not a secret, and revoking access does not mean rotating a key.

Every call on the record

Who asked, which agent acted, which action ran, and the verdict that let it through — one audit trail across every integration, not one per vendor.

What an agent can do

Each action is granted on its own. An agent allowed to read is not thereby allowed to write, and the scope beside each row is what the acting user must have connected for it to run at all.

redcircle_delete_collections_by_collection_idWRITE

Delete a Collection and everything in it.

api

redcircle_delete_collections_by_collection_id_by_request_idWRITE

Delete one Request from a Collection. Requests can only be deleted while the Collection is not running. Call this sequentially rather than in parallel -- too many concurrent calls are answered 429; to clear many, use the clear-requests tool or delete and re-create the Collection.

api

redcircle_delete_collections_by_collection_id_clearWRITE

Delete every Request in a Collection, leaving the Collection itself in place.

api

redcircle_delete_destinations_by_destination_idWRITE

Delete a Destination. Collections referencing it stop uploading their Result Sets there.

api

redcircle_delete_zipcodesWRITE

Delete zipcodes from your account. The body is an ARRAY of objects, each naming a zipcode and the domain to remove it from.

api

redcircle_get_accountWRITE

Retrieve your RedCircle account information, including the request credits used and remaining on the current plan.

api

redcircle_get_categoriesWRITE

List or search Target's category hierarchy. Returns known-good category IDs to use with type=category Target Product Data requests. id, parent_id and search_term are mutually exclusive -- supply at most one.

api

redcircle_get_collectionsWRITE

List the Collections on your account, with filtering, sorting and pagination. 25 Collections are returned per page by default.

api

redcircle_get_collections_by_collection_idWRITE

Retrieve one Collection, including whether it is currently running and how many Requests and Result Sets it holds.

api

redcircle_get_collections_by_collection_id_requests_by_pageWRITE

List one page of a Collection's Requests, 1000 per page, pages starting at 1. The Collection's requests_page_count field says how many pages there are. Supply q to search the Requests and their custom_ids, or custom_id to match one exactly.

api

redcircle_get_collections_by_collection_id_requests_csvWRITE

Retrieve download links for every Request in a Collection in CSV format, one link per page of results.

api

redcircle_get_collections_by_collection_id_requests_jsonWRITE

Retrieve download links for every Request in a Collection in JSON format, one link per page of results.

api

redcircle_get_collections_by_collection_id_resultsWRITE

List every Result Set for a Collection. RedCircle retains Result Sets for 14 days, so download the data within that window.

api

redcircle_get_collections_by_collection_id_results_by_result_set_idWRITE

Retrieve the results within one Result Set of a Collection.

api

redcircle_get_collections_by_collection_id_results_by_result_set_id_csvWRITE

Retrieve download links for one Result Set of a Collection in CSV format.

api

redcircle_get_collections_by_collection_id_results_by_result_set_id_jsonlinesWRITE

Retrieve download links for one Result Set of a Collection in JSON Lines format.

api

redcircle_get_collections_by_collection_id_results_by_result_set_id_resendwebhookWRITE

Ask RedCircle to re-send the webhook POST for one Result Set. Useful for debugging webhook connectivity without re-running the Collection.

api

redcircle_get_collections_by_collection_id_startWRITE

Start a Collection running. The account must hold enough request credits for every Request in the Collection. Any schedule_type can be started as long as it is not already running.

api

redcircle_get_collections_by_collection_id_stopWRITE

Stop a Collection that is queued or running. Credits allocated to a queued Collection are refunded; a Collection already running is stopped without a refund.

api

redcircle_get_collections_stopallWRITE

Stop every Collection on the account that is currently queued or running, setting them back to idle. Credits allocated to a queued Collection are refunded; a Collection already running is stopped without a refund.

api

redcircle_get_destinationsWRITE

List the Destinations on your account -- the S3, Google Cloud Storage, Azure Blob Storage or Alibaba Cloud OSS buckets that Collection Result Sets are uploaded to. 10 are returned per page.

api

redcircle_get_errorlogsWRITE

List the Error Logs on your account, which record requests that failed and why. 10 are returned per page.

api

redcircle_get_request_categoryWRITE

List the products in a Target category by category ID, with the same sorting, delivery-type, rating and facet filters as search. Category IDs come from the list-and-search-categories tool. Supply `category_id`, or a Target category `url` (which overrides every other parameter).

api

redcircle_get_request_productWRITE

Retrieve a single Target product's details -- title, brand, pricing, promotions, ratings, images, specifications and variants -- by TCIN (Target item ID), DPCI, GTIN/ISBN/UPC, or a Target product-page URL. Supply one of `tcin`, `dpci`, `gtin` or `url`: `url` overrides the other three, and `gtin` overrides `tcin` and `dpci`.

api

redcircle_get_request_reviewsWRITE

Retrieve customer reviews for a Target product, filtered by reviewer type, star rating and media type, and sorted. Identify the product by `tcin`, `dpci`, `gtin` or a Target product-page `url`.

api

redcircle_get_request_searchWRITE

Search Target for products by search term, with optional category, sorting, delivery-type, rating and facet filters, and pagination. Supply `search_term`, or a Target search-results `url` (which overrides every other parameter).

api

redcircle_get_request_store_stockWRITE

Retrieve in-store stock for a Target product across stores near a zipcode -- up to 20 stores within a 50 mile radius. Identify the product by `tcin`, `dpci`, `gtin` or `url`.

api

redcircle_get_zipcodesWRITE

List the zipcodes set up on your account. A maximum of 10 are returned per page.

api

redcircle_post_collectionsWRITE

Create a Collection, which runs up to 15,000 Requests on a schedule (100 when its Requests set include_html=true). An account may hold up to 10,000 Collections.

api

redcircle_post_destinationsWRITE

Create a Destination -- an S3, S3-compatible, Google Cloud Storage, Azure Blob Storage or Alibaba Cloud OSS bucket that Collection Result Sets are uploaded to.

api

redcircle_post_zipcodesWRITE

Add zipcodes to your account. The body is an ARRAY of objects, each naming a zipcode and the domain to use it on.

api

redcircle_put_collections_by_collection_idWRITE

Update a Collection's fields, and/or add Requests to it. These are the same endpoint: send the Collection's own fields to update it, or a `requests` array (up to 1000 per call) to add Requests. A Collection holds at most 15,000 Requests. Requests can only be added while the Collection is not running.

api

redcircle_put_collections_by_collection_id_by_request_idWRITE

Update one Request inside a Collection. Requests can only be updated while the Collection is not running. Call this sequentially rather than in parallel -- too many concurrent calls are answered 429.

api

redcircle_put_destinations_by_destination_idWRITE

Update a Destination. It takes the same fields as creating one.

api