RedCircle API
for LuumenAI
Read Target catalog data and run RedCircle collections from the terminal
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.
The RedCircle API toolbox
32 tools: 15 read, 17 write. Reads answer instantly. Writes require approval by default. Everything is logged.
- ReadGet Account InformationRetrieve account information, usage metrics, and platform status.
- ReadGet CollectionRetrieve complete information about a specific collection.
- ReadGet Requests CSV LinksRetrieve CSV download links for all requests in a collection.
- ReadGet Requests JSON LinksRetrieve download links for all requests in a collection in JSON format.
- ReadGet Result Set CSVRetrieve a result set in CSV format with optional field filtering.
- ReadGet Result Set JSONRetrieve a result set in JSON format with download links.
- ReadGet Result Set JSON LinesRetrieve a result set in JSON Lines format with download links.
- ReadGet Target Product DataRetrieve Target data in real-time including search results, product information, reviews, or category listings.
- ReadList CategoriesRetrieve all top-level (root) categories or filter results using optional parameters.
- ReadList CollectionsRetrieve all collections configured on your RedCircle API account with filtering and pagination.
- ReadList DestinationsRetrieve all destinations configured on your RedCircle API account with pagination and filtering.
- ReadList Error LogsList all error logs on your RedCircle API account.
- ReadList Requests by PageRetrieve requests for a collection in paginated format.
- ReadList Result SetsList all result sets for a collection.
- ReadList ZipcodesRetrieve all zipcodes associated with your account with optional filtering.
- WriteAdd ZipcodesAdd zipcodes to your RedCircle API account for geolocation targeting. Approval by default
- WriteClear Collection RequestsRemove all requests from a specified collection. Approval by default
- WriteCreate CollectionCreate a new collection for running up to 15,000 requests on a schedule. Approval by default
- WriteCreate DestinationCreate a new destination for uploading Collection Result Sets to cloud storage. Approval by default
- WriteCreate RequestsAdd up to 1,000 requests to an existing collection. Approval by default
- WriteDelete CollectionRemove a collection from the system by ID. Approval by default
- WriteDelete DestinationRemove a destination from your RedCircle API account. Approval by default
- WriteDelete Request from CollectionRemove an individual request from a collection. Approval by default
- WriteDelete Requests In BulkDelete multiple requests from a collection in bulk. Approval by default
- WriteDelete ZipcodesRemove zipcodes from your RedCircle API account. Approval by default
- WriteResend WebhookResend a previously configured webhook POST request for a result set. Approval by default
- WriteStart CollectionInitiate execution of a RedCircle API collection. Approval by default
- WriteStop All CollectionsHalt all currently active collections on your account. Approval by default
- WriteStop CollectionHalt an active collection in queued or running state. Approval by default
- WriteUpdate CollectionUpdate an existing collection's configuration and settings. Approval by default
- WriteUpdate DestinationModify an existing destination configuration on your RedCircle API account. Approval by default
- WriteUpdate RequestModify a request within a collection. Approval by default
One prompt, start to finish
What a governed RedCircle API run looks like inside Luumen.
Questions
Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.
Read actions answer immediately. Anything that writes — add zipcodes, clear collection requests, create collection, create destination, and more — is shown as a plan and requires approval by default, including the 8 actions classified as destructive. Administrators configure that per tool, so you decide exactly which actions can ever run unattended.
You decide. Actions are granted per agent, skill, and team, and per environment — production is not staging. Read access can be broad while writes stay narrow.
Every call to RedCircle API — read or write, approved or declined — is recorded with the actor, the input, and the result, and can be linked to the ticket or change record.
Often connected alongside
All integrations
GitHubRepos, actions, and runbook code as context and as actions.
GitLabMerge requests and pipelines proposed, triggered, and rolled back.
BitbucketRead commits, diffs, and branches in Bitbucket, then open the fix as a held write.
Azure DevOpsAzure DevOps repos and pipelines as context — and as approved actions.Put RedCircle API to work with Luumen
Connect in minutes. Every action scoped, approved, and audited from day one.