Docs / API / Plan an article

Plan an article

Put a keyword on the calendar for the Copywriter to write.

3 min de lecture Paid plans

POST /api/v1/articles

An article has two lives. First a plan — a keyword with a date — then the article the Copywriter makes from it. This files the plan; the writing happens as the date approaches.

keyword string OBLIGATOIRE

What the article should rank for. QuQi never invents this.

website_id string OBLIGATOIRE

Which of your websites.

style string FACULTATIF

The shape of the article. Leave it out to use this website's own setting.

length string FACULTATIF

1200, 1500, 2000 or 3000 words.

instructions string FACULTATIF

Anything this one article must cover, mention or avoid.

scheduled_for string FACULTATIF

The day it should be written. Defaults to today. Cannot be in the past.

mode string FACULTATIF

How far it goes on its own. Defaults to draft — the same four as posts.

ATTENTION Publishing an article means pushing it to your live website. draft is the default for that reason — nothing reaches your site unless you ask.

A request with no keyword is refused rather than guessed at. An article written for a keyword nobody chose spends a month's allowance on something nobody wanted.

CURL

curl -X POST https://console.quqi.io/api/v1/articles \
  -H "Authorization: Bearer quqi_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "website_id": "019feda8-0ca6-70d1-b927-697fa6650cda",
    "keyword": "car loan for bad credit",
    "length": "2000"
  }'

RESPONSE 202

{
  "success": true,
  "data": {
    "id": "01a0…",
    "status": "planned",
    "keyword": "car loan for bad credit",
    "length": "2000",
    "mode": "draft",
    "scheduled_for": "2026-09-02T08:55:00+00:00",
    "what_happens": "It is written as its slot approaches and waits as a draft. Nothing is published on its own."
  }
}

Cette page a-t-elle répondu à votre question ? Oui Pas vraiment

Publish a post

List written articles