Skip to main content
Topify.ai exposes three REST APIs:
APIPurposeBase pathAuth
Public APIRead-only access to GEO analytics data/api/public/v1API key (X-API-Key)
Data analysis APIBrand tracking, prompts, competitors, sources, teams, billing/api/v1 and /api/v2Bearer token
Content generation APIArticle creation and management/api/v1Bearer token
The public API is designed for external integrations and uses API key authentication. The data analysis and content generation APIs are internal services used by the Topify.ai platform.

​
Response format

​
Data analysis API

Most endpoints return responses in this format: 
{
  "success": true,
  "data": { ... }
}
On error: 
{
  "success": false,
  "error": "Description of what went wrong"
}

​
Content generation API

Responses return the data directly (no wrapper). Errors return: 
{
  "error": "Description of what went wrong",
  "code": "ERROR_CODE"
}

​
Common HTTP status codes

CodeMeaning
200Success
201Created
202Accepted (async operation started)
400Bad request (invalid parameters)
401Unauthorized (missing or invalid token)
403Forbidden (no access to this resource)
404Not found
409Conflict (e.g., duplicate entry)
429Usage limit exceeded (plan quota reached)

​
API versioning

The data analysis API has two versions:
  • v1 — used for bootstrap, membership, and some legacy endpoints
  • v2 — the current version for projects, prompts, competitors, sources, and teams
Both versions are active and documented here. New integrations should prefer v2 endpoints where available.

​
Next steps

Public API

Get started with API key access to your data.

Authentication

Learn how to authenticate your API requests.

Bootstrap

Initialize a new project with AI analysis.