API Reference
Create a new topic
X-API-Key<token>
API Key for programmatic access
In: header
Path Parameters
domainId*string
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
curl -X POST "https://example.com/api/domains/string/topics" \ -H "Content-Type: application/json" \ -d '{}'{ "id": "123e4567-e89b-12d3-a456-426614174000", "domainId": "123e4567-e89b-12d3-a456-426614174000", "name": "AI and Machine Learning", "description": "Discussions about artificial intelligence and ML technologies", "icon": "Brain", "keywords": [ "artificial intelligence", "machine learning", "AI" ], "language": "en", "market": "US", "persona": "Marketing manager evaluating running shoe brands", "visibilityPrompts": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "text": "What are the best running shoe brands?", "createdAt": "2026-05-25T10:30:00.000Z", "updatedAt": "2026-05-25T10:30:00.000Z" } ], "competitionPrompts": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "text": "How does nike.com compare to its competitors?", "createdAt": "2026-05-25T10:30:00.000Z", "updatedAt": "2026-05-25T10:30:00.000Z" } ], "organizationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "createdAt": "2026-05-25T10:30:00.000Z", "updatedAt": "2026-05-25T10:30:00.000Z", "lastAnalysisAt": "2026-05-25T10:30:00.000Z", "nextAnalysisAt": "2026-05-26T10:30:00.000Z", "enabledFeatures": { "visibility": true, "competition": true, "ads": true }, "sortOrder": 0, "competitors": [ { "id": "6736c1a8a0b2f1e2d3c4b5a6", "name": "OpenAI", "urls": [ "https://openai.com", "https://chat.openai.com" ], "aliases": [ "OAI" ] } ]}