Blog

The Blog pillar is a full content engine — not a header-and-body table. Posts have categories and tags, scheduling, multi-language translations, featured images, SEO meta, and an optional pipeline where Neural Draft researches, writes and illustrates a post and translates it, as one async job. Posts you (or your own AI) write are free.

What this gives you

Posts with draft, scheduled, published, archived lifecycle.
Translations per language with their own title, content, excerpt, and SEO meta.
Categories and tags with slugs, attached many-to-many.
Scheduling — set scheduled_at and we publish at the precise minute.
Written by Neural Draft — one POST (type: "ai") researches, writes and illustrates the post, adds SEO meta and translates it into the target languages. Pass generate_images: false for a text-only post.
Hosted blog on the site address (and blog.yourdomain.com in blog-only mode), plus <nd-blog-feed> for any page.

Quick example

Create a published post in English, then async-translate it into French:

import { NeuralDraftClient } from "@neuraldraft/sdk";

const nd = new NeuralDraftClient({ apiKey: process.env.NEURALDRAFT_API_KEY! });

// Manual create: free. The SDK sets type="manual".
const post = await nd.blogPosts.create({
  title: "Five things we shipped this week",
  content: "<p>It was a busy week.</p>",
  excerpt: "Highlights from the past seven days.",
  language_code: "en",
  status: "published",
});

// Async translate by Neural Draft — returns a Job; 10 credits per language.
const job = await nd.blogPosts.translate(post.id, ["fr"]);
await nd.jobs.poll(job.id);

# Manual create — note the discriminator: type=manual
curl -X POST https://api.neuraldraft.io/v1/blog-posts \
  -H "Authorization: Bearer $NEURALDRAFT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "manual",
    "title": "Five things we shipped this week",
    "content": "<p>It was a busy week.</p>",
    "excerpt": "Highlights from the past seven days.",
    "language_code": "en",
    "status": "published"
  }'

# Translate the post asynchronously (returns a Job)
curl -X POST https://api.neuraldraft.io/v1/blog-posts/4711/translate \
  -H "Authorization: Bearer $NEURALDRAFT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target_languages":["fr"]}'

Common workflows

1. Generate a multi-language post end to end

The headline workflow. One POST kicks off the full pipeline (research → outline → write → featured-image → SEO meta → per-language translations) and returns a Job reference. Subscribe to blog_post.published for the finished result, or poll.

SDK

const job = await nd.blogPosts.generateAi({
  topic: "Why API-first beats site-builder-first for SMBs",
  style: "thought_leadership",
  word_count: 1200,
  primary_keyword: "API-first CMS",
  translate_to_all: true, // translate into every project target language
  enable_research: true,
});

const finished = await nd.jobs.poll(job.id, { timeoutMs: 10 * 60_000 });
// finished.result?.blog_post_id

cURL

# Same endpoint as manual create — discriminator: type=ai
curl -X POST https://api.neuraldraft.io/v1/blog-posts \
  -H "Authorization: Bearer $NEURALDRAFT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "ai",
    "topic": "Why API-first beats site-builder-first for SMBs",
    "style": "thought_leadership",
    "word_count": 1200,
    "primary_keyword": "API-first CMS",
    "translate_to_all": true,
    "enable_research": true
  }'

Cost: 60 credits for the post (blog_post: research, writing and its images). Each extra language is 10 credits (translate_language).

2. Schedule a post for next Tuesday

SDK

await nd.blogPosts.schedule(4711, "2026-05-19T09:00:00Z");
// Or: nd.blogPosts.schedule(4711, new Date(...))

cURL

curl -X POST https://api.neuraldraft.io/v1/blog-posts/4711/schedule \
  -H "Authorization: Bearer $NEURALDRAFT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"scheduled_at":"2026-05-19T09:00:00Z"}'

The post enters scheduled state. At the exact minute we transition it to published and fire the blog_post.published webhook.

3. Edit and republish

Patch a published post in-place. Text fields (title, content, excerpt, meta_title, meta_description) write to the translation row resolved by language_code (default en); post-level fields (slug, status, category_id, featured_image) write to the post itself.

SDK

await nd.blogPosts.update(4711, {
  title: "Five things we shipped (updated)",
  language_code: "en",
});

cURL

curl -X PATCH https://api.neuraldraft.io/v1/blog-posts/4711 \
  -H "Authorization: Bearer $NEURALDRAFT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Five things we shipped (updated)","language_code":"en"}'

4. Translate an existing post into a new language

SDK

const job = await nd.blogPosts.translate(4711, ["es", "it"]);
await nd.jobs.poll(job.id);

Cost: 10 credits per language (translate_language). Writing the translation with your own assistant and saving it with update is free.

5. Lifecycle helpers

SDK

await nd.blogPosts.publish(4711);
await nd.blogPosts.unpublish(4711);
await nd.blogPosts.delete(4711);

// List + filter
const { data: drafts } = await nd.blogPosts.list({
  status: "draft",
  page_size: 20,
  sort: "-created_at",
});

Reference

Endpoint	Scope
`GET /v1/blog-posts`, `GET /v1/blog-posts/{id_or_slug}`	`blog:read`
`POST /v1/blog-posts` (`type: "manual"` or `"ai"`)	`blog:write`
`PATCH /v1/blog-posts/{id}`, `DELETE /v1/blog-posts/{id}`	`blog:write`
`POST /v1/blog-posts/{id}/publish`	`blog:publish`
`POST /v1/blog-posts/{id}/unpublish`, `/schedule`	`blog:write`
`POST /v1/blog-posts/{id}/translate` (`target_languages`) or `/translations` (`language_code`)	`blog:write`
`GET/POST /v1/blog-posts/categories`, `PATCH/DELETE /v1/blog-posts/categories/{id}`	`blog:read` / `blog:write`
`GET/POST /v1/blog-posts/tags`, `PATCH/DELETE /v1/blog-posts/tags/{id}`	`blog:read` / `blog:write`
`GET /v1/jobs/{id}`, `GET /v1/jobs/{id}/stream`	`jobs:read`

Get started

Build with AI

Sites

Agencies

Features

SDK and API

Snippets

What this gives you

Quick example

Common workflows

1. Generate a multi-language post end to end

2. Schedule a post for next Tuesday

3. Edit and republish

4. Translate an existing post into a new language

5. Lifecycle helpers

Reference

​What this gives you

​Quick example

​Common workflows

​1. Generate a multi-language post end to end

​2. Schedule a post for next Tuesday

​3. Edit and republish

​4. Translate an existing post into a new language

​5. Lifecycle helpers

​Reference

What this gives you

Quick example

Common workflows

1. Generate a multi-language post end to end

2. Schedule a post for next Tuesday

3. Edit and republish

4. Translate an existing post into a new language

5. Lifecycle helpers

Reference