Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cognerd.in/llms.txt

Use this file to discover all available pages before exploring further.

The Content Studio blog endpoint generates SEO- and AEO-optimized articles for your brand. You provide a topic and your brand name, choose a length, and CogNerd’s multi-stage pipeline — covering SEO analysis, competitor research, intent classification, content generation, and RAGAS quality evaluation — produces a publish-ready markdown article.
Credit cost: Short blog = 10 credits, Long blog = 30 credits. Credits are deducted when generation starts. Make sure your balance is sufficient before calling this endpoint.

Generate a blog post

curl -X POST https://api.cognerd.in/content-studio/create-blog \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "topic": "How AI search is changing B2B buying",
    "brandName": "Acme Corp",
    "length": "short"
  }'

Request body

topic
string
required
The blog post topic or working title. Be specific — a focused topic produces better results than a broad one.
brandName
string
required
Your brand name. Used to align tone, include brand-relevant references, and ensure the content supports your visibility goals.
length
string
required
Blog length. One of "short" (800–1,200 words, 10 credits) or "long" (2,500–4,000 words, 30 credits).

Response

{
  "id": "blog_7f3a21",
  "status": "completed",
  "topic": "How AI search is changing B2B buying",
  "brandName": "Acme Corp",
  "length": "short",
  "content": "# How AI Search Is Changing B2B Buying\n\nArtificial intelligence has reshaped...",
  "createdAt": "2024-01-15T11:00:00Z"
}
id
string
Unique identifier for this blog document.
status
string
Generation status: "completed", "pending", or "failed".
content
string
The full blog post in markdown format, ready to paste into your CMS or publish directly.
createdAt
string
ISO 8601 timestamp.

Retrieve the latest blog

Use this endpoint to fetch the most recently generated blog for your account without needing the id.
curl https://api.cognerd.in/content-studio/latest \
  -H "Authorization: Bearer YOUR_TOKEN"

Error responses

StatusCodeMeaning
401UNAUTHORIZEDMissing or invalid Bearer token
402INSUFFICIENT_CREDITSNot enough credits for the chosen length
400VALIDATION_ERRORMissing required fields (topic, brandName, length)
500GENERATION_FAILEDContent generation failed; retry the request
For best results, use specific topics tied to questions your target audience is asking AI platforms. Check your Brand Monitor to see what queries are driving competitor citations, then create content that answers those same questions.