Skip to main content
Topify.ai exposes two separate REST APIs:
APIPurposeBase path
Data analysis APIBrand tracking, prompts, competitors, sources, teams, billing/api/v1 and /api/v2
Content generation APIArticle creation and management/api/v1
These are separate services with separate base URLs. Your Topify.ai dashboard handles both automatically, but if you’re building custom integrations, you’ll need to know which API to call.

​
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

Authentication

Learn how to authenticate your API requests.

Bootstrap

Initialize a new project with AI analysis.