التوثيق
ESC
تسجيل الدخول استخدام QuQi
API
Getting started
The QuQi API Authentication
Your account
GET List your websites POST Issue a narrowed key
Channels
GET List channels GET One channel
Posts
POST Plan a post GET List posts GET One post POST Publish a post
Articles
POST Plan an article GET List written articles GET One written article
The calendar
GET The calendar
Pictures
POST Make a picture GET The picture library GET Check a task
Webhooks
POST Add a webhook GET List webhooks DELETE Remove a webhook
Reading finished work
GET Status GET Keywords GET List articles GET One article POST Connect a site POST Disconnect a site
Getting started
Errors

Plan an article

Have the Copywriter write an article for a keyword you choose.

قراءة 3 دقائق Paid plans
POST /api/v1/articles

Send a keyword and the Copywriter starts writing straight away; this answers 202 while it works. What happens once it is written depends on mode and on the website’s Articles switch in Approvals, exactly as for posts. Ask for a later date and the finished article waits for that date before it goes out.

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 go out. Defaults to today. Cannot be in the past.
mode string اختياري
How far it goes on its own. Defaults to draft — the same as posts: anything but publish waits for the owner’s OK in the Copywriter’s chat.
انتبه Publishing an article means pushing it to your live website. draft is the default for that reason: nothing reaches your site until the owner approves it, unless you send publish to a website with Articles on.

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": "queued",
    "keyword": "car loan for bad credit",
    "length": "2000",
    "mode": "draft",
    "scheduled_for": "2026-09-02T08:55:00+00:00",
    "what_happens": "The Copywriter writes it now, and it waits for the owner's OK in the Copywriter's chat. Nothing is published before."
  }
}
هل أجابت هذه الصفحة عن سؤالك؟ نعم ليس تمامًا