Article Generation

The Article Generation API allows you to trigger long-form content creation using WriteIQ’s agentic engine. Because generating comprehensive articles can take several minutes, this API is asynchronous. You first trigger a generation job, and then poll for its status.

Generate Article Job

POST /v1/articles

Triggers a new article generation workflow.

Request Body

Field	Type	Description
keyword	string	Required. The primary keyword or topic for the article.
tone	string	Optional. The desired tone of voice (e.g., “Professional”, “Conversational”).
writerConfig	object	Optional. Configuration overrides for the AI Writer.
extraInstructions	string	Optional. Additional instructions to append to the system prompt.
publishTarget	string	Optional. A destination to automatically publish to upon completion (e.g., a connected WordPress ID).

writerConfig Options:

• articleType (“blog_post”, “listicle”, “amazon_roundup”, “youtube_to_blog”)
• articleLength (“short”, “medium”, “long”)
• pointOfView (“first_person”, “second_person”, “third_person”)
• realTimeData (boolean, defaults to true)

Example Request

curl -X POST https://api.writeiq.com/v1/articles \
  -H "Authorization: Bearer wiq_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "Best mechanical keyboards 2026",
    "tone": "Authoritative",
    "writerConfig": {
      "articleType": "amazon_roundup",
      "realTimeData": true
    }
  }'

Example Response

{
  "success": true,
  "jobId": "job_api_8f7d9a...",
  "status": "pending"
}

---

Check Job Status

GET /v1/articles/:id

Retrieves the status and final output of an article generation job.

Example Request

curl -X GET https://api.writeiq.com/v1/articles/job_api_8f7d9a... \
  -H "Authorization: Bearer wiq_YOUR_API_KEY"

Example Response (Pending)

{
  "job": {
    "id": "job_api_8f7d9a...",
    "status": "pending",
    "keyword": "Best mechanical keyboards 2026",
    "createdAt": "2026-05-06T12:00:00Z"
  }
}

Example Response (Completed)

{
  "job": {
    "id": "job_api_8f7d9a...",
    "status": "completed",
    "keyword": "Best mechanical keyboards 2026",
    "result": "# Best Mechanical Keyboards 2026\n\nIf you are looking for...",
    "casResultHash": "a1b2c3d4e5f6...",
    "createdAt": "2026-05-06T12:00:00Z"
  }
}