Documentação / API / Plan an article

Plan an article

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

3 min de leitura 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 OBRIGATÓRIO

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

website_id string OBRIGATÓRIO

Which of your websites.

style string OPCIONAL

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

length string OPCIONAL

1200, 1500, 2000 or 3000 words.

instructions string OPCIONAL

Anything this one article must cover, mention or avoid.

scheduled_for string OPCIONAL

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

mode string OPCIONAL

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

ATENÇÃO 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."
  }
}

Esta página respondeu à sua pergunta? Sim Nem por isso

Publish a post

SEGUINTE

List written articles