REST API

GrackerAI's REST API enables custom integrations beyond the prebuilt connectors.

Authentication

All API requests require an API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Generate keys at Configure → Integrations → API. Rotate keys every 90 days; revoke immediately if exposed.

Base URL

https://api.gracker.ai/v1

Core Endpoints

Example: Bulk-Import Prompts

curl -X POST https://api.gracker.ai/v1/prompts/bulk \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompts": [
      {
        "text": "Best EDR for healthcare SaaS",
        "type": "Organic",
        "intent": "Commercial",
        "group": "EDR-Healthcare"
      },
      {
        "text": "CrowdStrike alternatives",
        "type": "Competitor Comparison",
        "intent": "Commercial",
        "group": "Comp-CrowdStrike"
      }
    ]
  }'

Example: Pull This Week's Citations

curl "https://api.gracker.ai/v1/citations?since=2026-04-20&limit=100" \
  -H "Authorization: Bearer YOUR_API_KEY"

Rate Limits

Exceeded limits return 429 Too Many Requests with a Retry-After header.

SDKs

Official SDKs:

• Node.js / TypeScript — npm install @grackerai/sdk
• Python — pip install grackerai

Webhooks

Subscribe to real-time events instead of polling:

Configure webhook URLs at Configure → Integrations → Webhooks.

Status Page

Monitor API uptime at status.gracker.ai (opens in a new tab).