API Reference
Create a brief research and start pipeline
POST
header
AuthorizationBearer <token>Session JWT signed with HS256. Verification pins the algorithm and rejects expired tokens, per RFC8725.
domainId*stringDomain ID
application/json- body
dateRange?stringValue in
"24h""7d""30d""90d""6m"priority?stringValue in
"critical""high""medium""low""all"topicId?stringtopicName?stringpromptName?stringDisplay label of the targeted prompt. The research is scoped by promptIds, never by this text.
promptIds?array<string>IDs of the prompts to research (the promptIds of a content gap). Required with promptName; omit both for topic-wide research.
Items
1 <= items <= 20gapLimit?numberRange
1 <= value <= 50Default
10crawlLimit?numberRange
1 <= value <= 10Default
5market?stringlanguage?stringapplication/json- response
id*stringstatus*stringcurrentStep*numbertotalSteps*numbercurrentStepName?stringerrorMessage?stringcreatedAt*stringcompletedAt?stringgapCount?numberkeywordCount?numbertopKeywords?array<string>topGaps?array<string>topicName?stringpromptName?stringcommonTopics?array<string>contentStructures?array<string>curl -X POST 'https://api.getmint.ai/api/domains/string/content-studio-v2/brief-researches' \ -H 'Content-Type: application/json' \ -d '{}'{ "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "status": "completed", "currentStep": 6, "totalSteps": 6, "currentStepName": "compileResults", "errorMessage": "Keyword volume provider timed out", "createdAt": "2026-05-25T10:30:00.000Z", "completedAt": "2026-05-25T10:35:00.000Z", "gapCount": 12, "keywordCount": 48, "topKeywords": [ { "keyword": "best running shoes", "searchVolume": 27000 } ], "topGaps": [ { "topicName": "Trail running", "percentage": 42 } ], "topicName": "Running shoes", "promptName": "best running shoes for beginners", "commonTopics": [ "cushioning", "arch support", "pronation" ], "contentStructures": [ "Listicle", "Comparison table", "FAQ" ]}