Overview

API v3 is the primary AIXBT API: one consistent view of Projects, Topics, Intel, Reports, and Clusters, available over REST and MCP with identical data. The base URL is https://api.aixbt.tech/v3; the OpenAPI document is served at /v3/openapi.yaml, with interactive docs at https://api.aixbt.tech/v3/docs.

Authentication

Current Topic list and detail are the keyless free tier:

curl --fail-with-body "https://api.aixbt.tech/v3/topics"

Everything else requires a key from Developer access, sent in the x-api-key header:

curl --fail-with-body "https://api.aixbt.tech/v3/projects?limit=5" \
  -H "x-api-key: YOUR_API_KEY"

Call GET /v3/me to see your credential, entitlements, rate limits, and history window.

Responses

Every success body is {data, meta}. Failures return one typed error object. List endpoints use cursor and limit; follow meta.nextCursor until it is null.

{
  "data": [],
  "meta": { "nextCursor": null }
}

Find data

GET /v3/intel?search=... runs deep search across project identity and Intel text. Use GET /v3/vocabulary for valid filter values, and the Reference for exact parameters, schemas, and examples.

Migrating from v2

The migration guide maps every v2 route and field to its v3 equivalent.