QuQi API Open console
ESC
Open console Using QuQi
PLATFORM API
Platform API Authentication GET Status GET Keywords GET List articles GET One article POST Connect and disconnect Errors
Docs / Platform API / Keywords

Keywords

The article ideas sitting on your calendar for one month, in the order they are scheduled.

3 min read All plans
GET /api/v1/platform/keywords

This is the month view of what is coming: every article idea scheduled in the month you ask for, ordered by its scheduled date, each with the search volume and difficulty the planner found for it. Both parameters are required — there is no default month and no default year.

month integer REQUIRED
A whole number from 1 to 12.
year integer REQUIRED
A whole number from 2020 to 2100.

The response carries back the month and the year you asked for, and the list itself sits at data.keywords.

What status can say

An entry’s status is one of five words, and it is the fastest way to draw a calendar of your own.

  • scheduled — planned for its date, not written yet.
  • in_progress — being written right now.
  • draft — written and waiting for you.
  • published — written and pushed to your site.
  • failed — the write did not finish.
CURL
curl "https://console.quqi.io/api/v1/platform/keywords?month=8&year=2026" \
  -H "Authorization: Bearer quqi_YOUR_KEY"
RESPONSE
{
  "success": true,
  "data": {
    "month": 8,
    "year": 2026,
    "keywords": [
      {
        "id": "4c8f1b02-77a5-4f6e-9d31-0b52a9c4e618",
        "keyword": "sourdough starter care",
        "scheduled_date": "2026-08-14",
        "status": "published",
        "search_volume": 2400,
        "difficulty": 31,
        "article_status": "published",
        "article_title": "How to keep a sourdough starter alive"
      }
    ]
  }
}
Did this page answer your question? Yes Not quite