POST /content-studio/create-blog — Generate Blog Content

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"
  }'

curl -X POST https://api.cognerd.in/content-studio/create-blog \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "topic": "The complete guide to AI visibility for SaaS brands",
    "brandName": "Acme Corp",
    "length": "long"
  }'

const response = await fetch('https://api.cognerd.in/content-studio/create-blog', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    topic: 'How AI search is changing B2B buying',
    brandName: 'Acme Corp',
    length: 'short'
  })
});
const blog = await response.json();
console.log(blog.content); // Markdown content

Request body

string

required

The blog post topic or working title. Be specific — a focused topic produces better results than a broad one.

string

required

Your brand name. Used to align tone, include brand-relevant references, and ensure the content supports your visibility goals.

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"
}

string

Unique identifier for this blog document.

string

Generation status: "completed", "pending", or "failed".

string

The full blog post in markdown format, ready to paste into your CMS or publish directly.

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"

const response = await fetch('https://api.cognerd.in/content-studio/latest', {
  headers: { 'Authorization': 'Bearer YOUR_TOKEN' }
});
const latest = await response.json();

Error responses

Status	Code	Meaning
401	`UNAUTHORIZED`	Missing or invalid Bearer token
402	`INSUFFICIENT_CREDITS`	Not enough credits for the chosen length
400	`VALIDATION_ERROR`	Missing required fields (`topic`, `brandName`, `length`)
500	`GENERATION_FAILED`	Content 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.

Get Started

Dashboard

Guides

Credits & Plans

Help

POST /content-studio/create-blog — Generate Blog Content

Generate a blog post

Request body

Response

Retrieve the latest blog

Error responses

​Generate a blog post

​Request body

​Response

​Retrieve the latest blog

​Error responses

Generate a blog post

Request body

Response

Retrieve the latest blog

Error responses