NEWFree AI visibility report. Monitoring from $125/month

ChatGPT & other agents

CiteHawk publishes a machine-readable OpenAPI spec for the REST API, so any agent that speaks OpenAPI — a ChatGPT custom GPT, a LangChain or LlamaIndex tool, an internal agent framework — can call your visibility data directly.

The OpenAPI spec

The spec lives at a stable URL:

https://www.citehawk.com/openapi.json

It describes the /api/v1 endpoints (brands, metrics, responses) and the Bearer authentication scheme. Point any importer at it rather than hand-writing tool definitions.

ChatGPT custom GPT Action

To give a custom GPT live access to your CiteHawk data:

  1. In the GPT editor, open Configure > Actions > Create new action.
  2. Under Schema, choose Import from URL and paste https://www.citehawk.com/openapi.json.
  3. Set Authentication to API Key, type Bearer, and paste your workspace API key from Settings > API Keys.
  4. Save. The GPT can now call CiteHawk — ask it questions like “what is my AI visibility score this week?” and it will fetch live data.

Any agent framework

The same spec works anywhere. Most frameworks can generate tools from an OpenAPI document; give yours the spec URL and configure the auth header:

Authorization: Bearer YOUR_API_KEY

If your framework prefers raw HTTP over generated tools, the underlying endpoints are documented in the REST API reference. Working in Claude or Cursor instead? The MCP server is the more direct path there.