# RedCircle API AI integration on Definable

> RedCircle API is the real-time Target product data API for accessing Target product catalog, reviews, and category data.

## What this connects

RedCircle API is the real-time Target product data API for accessing Target product catalog, reviews, and category data.

Vendor: https://www.redcircleapi.com/

## Tools available

**32** tools available. First 12:

- `REDCIRCLE_API_ADD_ZIPCODES` — Add Zipcodes — Tool 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 become available after being added.
- `REDCIRCLE_API_CLEAR_COLLECTION_REQUESTS` — Clear Collection Requests — Tool 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.
- `REDCIRCLE_API_CREATE_COLLECTION` — Create Collection — Tool 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 notification methods.
- `REDCIRCLE_API_CREATE_DESTINATION` — Create Destination — Tool 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 S3-compatible storage.
- `REDCIRCLE_API_CREATE_REQUESTS` — Create Requests — Tool 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). Sequential calls required; parallel requests trigger HTTP 429 errors.
- `REDCIRCLE_API_DELETE_COLLECTION` — Delete Collection — Tool to remove a collection from the system by ID. Use when you need to delete a collection that is not currently running.
- `REDCIRCLE_API_DELETE_DESTINATION` — Delete Destination — Tool to remove a destination from your RedCircle API account. Use when you need to permanently delete a specific destination by its ID.
- `REDCIRCLE_API_DELETE_REQUEST` — Delete Request from Collection — Tool 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 during deletion.
- `REDCIRCLE_API_DELETE_REQUESTS_BULK` — Delete Requests In Bulk — Tool 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.
- `REDCIRCLE_API_DELETE_ZIPCODES` — Delete Zipcodes — Tool to remove zipcodes from your RedCircle API account. Use when you need to delete specific zipcode/domain pairs from your account.
- `REDCIRCLE_API_GET_ACCOUNT` — Get Account Information — Tool to retrieve account information, usage metrics, and platform status. Use when you need to check account credits, limits, plan details, or platform component status.
- `REDCIRCLE_API_GET_COLLECTION` — Get Collection — Tool to retrieve complete information about a specific collection. Use when you need detailed collection metadata including status, schedule, and configuration.

## Auth

Auth schemes: `API_KEY`.

## How agents use RedCircle API

Inside a Definable workflow, RedCircle API is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → RedCircle API** — the Researcher (GPT-5.5) pulls context from RedCircle API (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → RedCircle API** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into RedCircle API (create record, post message, draft email).
- **Designer / Engineer → Distributor → RedCircle API** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via RedCircle API (attach file, open PR comment, post status).

The Verifier checks every RedCircle API call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- developer tools — https://definable.ai/apps/category/developer-tools/
- ecommerce — https://definable.ai/apps/category/ecommerce/

## Related

- HTML page: https://definable.ai/apps/redcircle_api/
- Same category (developer tools): https://definable.ai/apps/category/developer-tools/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt