RedCircle API for AI agents
Agents read RedCircle API at once. Changes and sends are held for a person's approval by default.
About RedCircle API
RedCircle API is the real-time Target product data API for accessing Target product catalog, reviews, and category data.
What an agent can do in RedCircle API
Every RedCircle API action is classed by the platform as a read, a change or a send. Reads run at once. Changes and sends are held for a person by default.
Runs at once (reads)
Looks things up in RedCircle API without asking first. 15 actions.
- Get Account InformationTool to retrieve account information, usage metrics, and platform status. Use when you need to check account credits, limits, plan details, or platform component status.
- Get CollectionTool to retrieve complete information about a specific collection. Use when you need detailed collection metadata including status, schedule, and configuration.
- Get Target Product DataTool to retrieve Target data in real-time including search results, product information, reviews, or category listings. Use when you need to access Target.com product data such as searching for produc
- List CategoriesTool to retrieve all top-level (root) categories or filter results using optional parameters. Use when you need to browse the category hierarchy, search for specific categories, or retrieve category d
- List CollectionsTool to retrieve all collections configured on your RedCircle API account with filtering and pagination. Use when you need to browse collections, filter by status or search term, or manage collection
- List DestinationsTool to retrieve all destinations configured on your RedCircle API account with pagination and filtering. Use when you need to browse or manage destination configurations. Returns 10 destinations per
- List Result SetsTool to list all result sets for a collection. Use when you need to retrieve execution history and results for a specific collection. Note: result sets have 14-day retention.
- Get Requests CSV LinksTool to retrieve CSV download links for all requests in a collection. Use when you need to export request data in CSV format. Each CSV file contains up to 1000 requests.
- Get Requests JSON LinksTool to retrieve download links for all requests in a collection in JSON format. Use when you need to access request data from a specific collection. Returns paginated URLs for downloading request inf
- Get Result Set CSVTool to retrieve a result set in CSV format with optional field filtering. Use when you need to export processed results from a collection as CSV files. Supports field selection using dot notation for
- Get Result Set JSONTool to retrieve a result set in JSON format with download links. Use when you need to access processed results from a specific collection and result set. Returns detailed result information including
- Get Result Set JSON LinesTool to retrieve a result set in JSON Lines format with download links. Use when you need to access processed results as newline-delimited JSON files. JSON Lines format provides one valid JSON object
Show all 15
- List Error LogsTool to list all error logs on your RedCircle API account. Use when you need to retrieve failed API request logs with error details. Results are paginated with 10 error logs per page. Supports filteri
- List Requests by PageTool to retrieve requests for a collection in paginated format. Use when you need to access collection requests with pagination support (max 1000 requests per page).
- List ZipcodesTool to retrieve all zipcodes associated with your account with optional filtering. Use when you need to list zipcodes, optionally filtered by search term or domain. Supports pagination with max 10 re
Held for approval by default (changes and sends)
Held for a person's approval by default. The approval is recorded and the action is sent once, never twice, with 10 seconds to undo. 17 actions.
- Add ZipcodesTool to add zipcodes to your RedCircle API account for geolocation targeting. Use when you need to localize product searches by specific postal codes. New zipcodes take approximately 2 minutes to beco
- Clear Collection RequestsTool to remove all requests from a specified collection. Collections can only be cleared when not actively running. Use when you need to empty a collection of all its requests.
- Create CollectionTool to create a new collection for running up to 15,000 requests on a schedule. Use when you need to organize and schedule batch requests with various scheduling patterns, priority levels, and notifi
- Create DestinationTool to create a new destination for uploading Collection Result Sets to cloud storage. Use when you need to configure a storage destination for result sets with providers like S3, GCS, Azure, OSS, or
- Create RequestsTool to add up to 1,000 requests to an existing collection. Use when you need to populate a collection with product requests. Collections have a maximum of 15,000 requests (100 if include_html=true).
- Delete CollectionTool to remove a collection from the system by ID. Use when you need to delete a collection that is not currently running.
- Delete DestinationTool to remove a destination from your RedCircle API account. Use when you need to permanently delete a specific destination by its ID.
- Delete Request from CollectionTool to remove an individual request from a collection. Use when you need to delete a specific request from a collection by providing both collection_id and request_id. Collections must not be running
- Delete Requests In BulkTool to delete multiple requests from a collection in bulk. Use when you need to remove multiple requests efficiently. Note: Requests can only be deleted when the collection is not running.
- Start CollectionTool to initiate execution of a RedCircle API collection. Use when you need to start processing requests for a collection. Requires sufficient request credits and the collection must not be currently
- Stop All CollectionsTool to halt all currently active collections on your account. Use when you need to terminate all collection operations across your account. Collections in queued or running states are affected, reset
- Stop CollectionTool to halt an active collection in queued or running state. Use when you need to stop a collection that is currently processing. Collections in queued status receive full credit refunds, while runni
Show all 17
- Update CollectionTool to update an existing collection's configuration and settings. Use when you need to modify collection settings including name, schedule, priority, and destination assignments. Note: A collection
- Update DestinationTool to modify an existing destination configuration on your RedCircle API account. Use when you need to update destination settings such as name, credentials, storage paths, or enable/disable status.
- Update RequestTool to modify a request within a collection. Use only when the collection is not running. Updates request parameters like type, tcin, or other Target Product Data API fields.
- Delete ZipcodesTool to remove zipcodes from your RedCircle API account. Use when you need to delete specific zipcode/domain pairs from your account.
- Resend WebhookTool to resend a previously configured webhook POST request for a result set. Use when you need to debug webhook connectivity issues without re-executing the collection.
Changes wait in Needs you
Changes and sends in RedCircle API are held for a person's approval by default. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
Related connectors
RedCircle API questions
Can an agent change data in RedCircle API on its own?
Not by default. Changes and sends in RedCircle API are held for a person's approval. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
What can an agent read in RedCircle API?
This connector lists 15 read actions. Reads run at once, without waiting for approval.
How does RedCircle API connect?
It connects with API key. Connectors are built and maintained by third-party developers; availability is confirmed during scoping.