Documentation

Quickstart

Create a project API key under Developer, then read your feed:

curl "https://herculeradar.com/api/v1/mentions?category=complaint&min_urgency=60"   -H "Authorization: Bearer hr_live_…"

Start watching something new:

curl -X POST "https://herculeradar.com/api/v1/monitors"   -H "Authorization: Bearer hr_live_…"   -H "Content-Type: application/json"   -d '{
    "name": "Acme",
    "keywords": ["Acme", "acme.dev", "@acmehq"],
    "sources": ["x", "reddit", "youtube"]
  }'

The three surfaces

• REST — for scripts, backends and scheduled jobs.
• MCP — for Claude, ChatGPT and your own agents. Same capabilities, described for a model.
• Webhooks — for reacting the moment a mention is classified, instead of polling.

Machine-readable

• /openapi.json — OpenAPI 3.1, generated from the same registry as these pages.
• /llms.txt — short index for agents.
• /llms-full.txt — the full contract in one file.

Conventions

• Base URL: https://herculeradar.com/api/v1
• All requests and responses are JSON.
• Timestamps are ISO 8601 in UTC.
• Errors always take the shape { "error": { "code", "message" } }.
• An API key is scoped to exactly one project, so no project id is needed in requests.