التوثيق / API / Plan an article

Plan an article

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

قراءة 3 دقائق 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 مطلوب

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

website_id string مطلوب

Which of your websites.

style string اختياري

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

length string اختياري

1200, 1500, 2000 or 3000 words.

instructions string اختياري

Anything this one article must cover, mention or avoid.

scheduled_for string اختياري

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

mode string اختياري

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

انتبه 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."
  }
}

هل أجابت هذه الصفحة عن سؤالك؟ نعم ليس تمامًا

Publish a post

List written articles