Developer Docs

Red Flag AI Pro API

Scan marketing copy programmatically. Integrate compliance checking into your CMS, workflow or agency tools. Available on the Sentinel plan.

Why agencies use the API

Instead of your team manually pasting copy into the dashboard, the API lets you plug compliance scanning directly into the tools you already use. Your CMS can scan a page the moment it is published. Your project management tool can flag a task when copy fails. Your client portal can show a live compliance score without anyone lifting a finger. If it can make an HTTP request, it can use this API.

Get API key →Sentinel plan

Authentication

Pass your API key in the Authorization header on every request.

Authorization: Bearer rfp_your_api_key_here

Generate keys in Settings. Keys start with rfp_. Keep them secret.

Base URL

https://redflagaipro.com/api/v1

POST

/v1/scan

Scan marketing copy for compliance risks. Returns a score, risk level, and all flags with suggested fixes.

Request body

{
  "title": "My Sales Page",        // optional, string
  "content": "Your copy here..."   // required, string, min 20 chars
}

Example request

curl -X POST https://redflagaipro.com/api/v1/scan \
  -H "Authorization: Bearer rfp_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Landing Page",
    "content": "Earn six figures from home with our guaranteed system..."
  }'

Response

{
  "scan_id": "uuid",
  "title": "Landing Page",
  "score": 60,
  "risk": "medium",
  "flag_count": 2,
  "flags": [
    {
      "category": "income_claim",
      "severity": "high",
      "text_excerpt": "…six figures from home…",
      "description": "Contains an income claim...",
      "suggestion": "Add a clear earnings disclaimer..."
    }
  ],
  "scanned_at": "2026-05-29T11:00:00.000Z"
}

GET

/v1/scans

List your recent scans. Supports pagination.

Query parameters

limit   integer   Max results to return (default 20, max 100)
offset  integer   Number of results to skip (default 0)

Example request

curl https://redflagaipro.com/api/v1/scans?limit=10 \
  -H "Authorization: Bearer rfp_your_key"

Response

{
  "scans": [
    {
      "id": "uuid",
      "title": "Landing Page",
      "score": 60,
      "status": "complete",
      "created_at": "2026-05-29T11:00:00.000Z"
    }
  ],
  "total": 42,
  "limit": 10,
  "offset": 0
}

Webhooks

Set a webhook URL in Settings and we POST scan results there every time a scan completes - whether from the dashboard, URL scan, VSL scan, or API. Use with Zapier, Make, or your own backend.

Payload

{
  "event": "scan.completed",
  "scan_id": "uuid",
  "title": "Landing Page",
  "score": 60,
  "flag_count": 2,
  "flags": [
    {
      "category": "income_claim",
      "severity": "high",
      "suggestion": "Add a clear earnings disclaimer..."
    }
  ],
  "scanned_at": "2026-05-29T11:00:00.000Z"
}

Zapier setup

Create a new Zap with trigger: Webhooks by Zapier → Catch Hook
Copy the webhook URL Zapier gives you
Paste it into Settings → Webhook URL in Red Flag AI Pro
Run a scan to test the connection
Add your action (Slack message, Google Sheet row, email, etc.)

Risk categories

All 21 categories are scanned on Sentinel. Other plans scan 16.

income_claim

urgency

scarcity

testimonial

guarantee

health_claim

legal_disclaimer

contract_contradiction

data_privacy

hidden_fees

fake_reviews

comparative_advertising

email_compliance

dark_patterns

ai_disclosure

ai_endorsement

automated_decisions

financial_promotion

greenwashing

subscription_trap

influencer_disclosure

Rate limits

Sentinel plan: unlimited scans via dashboard. API calls are subject to fair use. If you need higher throughput, contact us.

Questions? Email support@redflagaipro.com