API Reference

Base URL: https://api.counteragent.io/v1

Authentication: Bearer token via Authorization: Bearer ca_live_...

Full OpenAPI spec: YAML | JSON

Detection

POST /v1/detect

Analyze request metadata to determine if a request originates from an AI agent.

POST /v1/detect
Content-Type: application/json
Authorization: Bearer ca_live_...

{
  "user_agent": "string",
  "ja4": "string (optional)",
  "ja4h": "string (optional)",
  "headers": {} (optional)
}

GET /v1/fingerprint/lookup?ja4=...

Look up a specific JA4/JA4S/JA4H/JA4X fingerprint in the database.

Agent Directory

GET /v1/agents

List all known AI agent frameworks. Filter by category: llm-sdk, browser-agent, orchestrator, crawler, mcp-client.

GET /v1/agents/{agent_id}

Get detailed information about a specific agent framework.

Signatures

GET /v1/signatures

Browse the signature database. Filter by type: ja4, ja4s, ja4h, ja4x.

POST /v1/signatures/submit

Submit a new fingerprint for analysis.

Tasks & Tools

GET /v1/tasks

List available analysis tasks for agentic workflows.

POST /v1/tasks/create

Create a new detection task. Supports batch analysis of multiple fingerprints.

GET /v1/tools

List available tools for MCP and A2A integrations.

POST /v1/execute

Execute a tool directly. Used by MCP clients and A2A agents.

Webhooks

POST /v1/webhooks

Register a webhook for real-time notifications. Events: new_agent, new_signature, threat_detected.

Statistics

GET /v1/stats

Platform statistics including total agents tracked, unique fingerprints, and detection rates.

Protocol Endpoints