---
title: "RedCircle API integration for LuumenAI"
url: "https://www.luumen.ai/integrations/redcircle-api/"
entity: SoftwareIntegration
category: "Source control & CI/CD"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# RedCircle API integration for LuumenAI

Read Target catalog data and run RedCircle collections from the terminal

## What LuumenAI can do with RedCircle API

LuumenAI connects to RedCircle API with an API token and exposes 32 tools (15 read-only · 9 write · 8 destructive). Reads answer immediately; writes are shown as a plan and require approval by default, configurable per tool by an administrator.

## Key facts

- Authentication: API token
- Tools available: 32 tools (15 read-only · 9 write · 8 destructive)
- Plan: available on all plans
- Category: Source control & CI/CD

## About RedCircle API with LuumenAI

Connect RedCircle API and Luumen can pull Target product, review, and category data in real time, plus the state of your collections, destinations, and error logs. Scheduled scrapes stop being a separate console: check what a collection holds, see where results land, then queue and start runs as approved steps.

## Example tools

Read-only (15 in total):

- `REDCIRCLE_API_GET_ACCOUNT` — Retrieve account information, usage metrics, and platform status.
- `REDCIRCLE_API_GET_COLLECTION` — Retrieve complete information about a specific collection.
- `REDCIRCLE_API_GET_REQUESTS_CSV_LINKS` — Retrieve CSV download links for all requests in a collection.
- `REDCIRCLE_API_GET_REQUESTS_JSON_LINKS` — Retrieve download links for all requests in a collection in JSON format.
- `REDCIRCLE_API_GET_RESULT_SET_CSV` — Retrieve a result set in CSV format with optional field filtering.
- `REDCIRCLE_API_GET_RESULT_SET_JSON` — Retrieve a result set in JSON format with download links.
- `REDCIRCLE_API_GET_RESULT_SET_JSONLINES` — Retrieve a result set in JSON Lines format with download links.
- `REDCIRCLE_API_GET_TARGET_PRODUCT_DATA` — Retrieve Target data in real-time including search results, product information, reviews, or category listings.

Write and destructive (17 in total, approval required by default):

- `REDCIRCLE_API_ADD_ZIPCODES` — Add zipcodes to your RedCircle API account for geolocation targeting.
- `REDCIRCLE_API_CLEAR_COLLECTION_REQUESTS` — Remove all requests from a specified collection.
- `REDCIRCLE_API_CREATE_COLLECTION` — Create a new collection for running up to 15,000 requests on a schedule.
- `REDCIRCLE_API_CREATE_DESTINATION` — Create a new destination for uploading Collection Result Sets to cloud storage.
- `REDCIRCLE_API_CREATE_REQUESTS` — Add up to 1,000 requests to an existing collection.
- `REDCIRCLE_API_DELETE_COLLECTION` — Remove a collection from the system by ID.
- `REDCIRCLE_API_DELETE_DESTINATION` — Remove a destination from your RedCircle API account.
- `REDCIRCLE_API_DELETE_REQUEST` — Remove an individual request from a collection.

## Frequently asked questions

### How does LuumenAI connect to RedCircle API?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in RedCircle API on its own?

Read actions answer immediately. Anything that writes is shown as a plan and requires approval by default, including the 8 actions classified as destructive. Administrators configure that per tool.

### Is there an audit trail?

Every call to RedCircle API — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/redcircle-api/