Generating articles

The request reserves credits and returns 202 right away; the article is written in the background. Follow progress as described in Generations & streaming. Only source is required — everything else has a sensible default.

curl https://reblogger.ai/api/v1/articles \
  -H "Authorization: Bearer $REBLOGGER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "source": { "type": "topic", "topic": "Balcony vegetable gardening for beginners" },
    "language": "en",
    "length": "medium",
    "tone": "friendly"
  }'

Sources: URL or topic#

Rewrite a URL#

With {"type": "url", "url": "https://…"} reblogger fetches the page, extracts the main article (WordPress sites are read through their REST API for cleaner content) and writes a new, original article on the same subject. rewrite_strength controls how far it moves away from the source: light keeps structure and key phrasing, moderate restructures, full (default) writes a fresh piece that only shares the facts.

Write about a topic#

With {"type": "topic", "topic": "…", "keywords": ["…"]} reblogger plans and writes an article from scratch. Be specific — “how to keep basil alive indoors in winter” produces a sharper article than “basil”. Optional keywords (up to 10) are woven in naturally.

Parameters#

Generated from the API schema, so it always matches what the API accepts.

Send an Idempotency-Key header to make retries safe — see Idempotency.

Lengths#

Tone & point of view#

point_of_view is first (“I/we”), second (“you”, default) or third. audience is free text such as “first-time home buyers in Germany”. For a consistent house style across all articles, create a brand voice in the dashboard and pass its id as brand_voice_id (Starter and up).

Languages#

Set language to write natively in any of 26 languages — the source can be in a different language.

Models & credits#

Pick a model with model; the default is claude-sonnet-5.5. Fast and balanced models cost 1 credit per article; premium models cost more. GET /models returns the models that are available to your account right now (respecting EU data residency) and whether your plan includes them.

Long articles add 1 credit, pillar articles add 2. Credits are reserved when you create the article and refunded automatically if the generation fails or you cancel it while queued. If your balance is too low you get 402 insufficient_credits.

Images#

image_count (0–3, capped by your plan) controls AI images: the first is the cover, the rest are placed inside sections. Images are included in the article price. Choose a model with image_model or pass null to skip images entirely. Every image comes with descriptive alt text.

SEO controls#

• focus_keyword — the primary keyword. It is used in the title, introduction, a subheading, the slug and the meta description. If omitted, reblogger picks one.
• include_faq — adds an FAQ section and returns it as structured faq (great for FAQPage schema).
• include_takeaways — a short “Key takeaways” box after the introduction.
• instructions — anything else: “mention our free trial”, “use metric units”, “no listicles”.

Every finished article includes a meta title, meta description, slug, excerpt, tags, categories and an on-page SEO score with individual checks.

Response#

{
  "generation": { "id": "cmh1x0gen7f2k0001", "object": "generation", "status": "queued", "progress": 0, "credits_charged": 1, … },
  "article_id": "cmh1x0art9q3m0001",
  "links": { "self": "…/generations/cmh1x0gen7f2k0001", "events": "…/events", "article": "…/articles/cmh1x0art9q3m0001" }
}

Add callback_url (HTTPS) to receive a one-off POST when this generation finishes, or register permanent, signed webhooks.