Articles API

List and read finished articles (Markdown + HTML), and trigger article generation for any keyword.

List articles

bash

GET /v1/sites/{site_id}/articles

# Filter by status
GET /v1/sites/{site_id}/articles?status=published&limit=20

Get an article

Returns the full article including both the HTML body and Markdown source.

bash

GET /v1/articles/{article_id}

json

{
  "article": {
    "id": "art_01hx9z...",
    "title": "10 Project Management Strategies for Remote Teams",
    "slug": "project-management-strategies-remote-teams",
    "keyword": "project management for remote teams",
    "status": "published",
    "wordCount": 2840,
    "bodyHtml": "<h2>Introduction</h2><p>...</p>",
    "bodyMarkdown": "## Introduction\n\n...",
    "excerpt": "Discover proven strategies...",
    "imageUrl": "https://cdn.indexpine.com/images/art_01hx9z.jpg",
    "cmsPostUrl": "https://myblog.com/blog/project-management-strategies-remote-teams",
    "publishedAt": "2025-07-22T09:15:00Z"
  }
}

Trigger article generation

Generate an article immediately for a specific keyword, bypassing the autopilot schedule. This is useful when you need a specific article written right now.

bash

POST /v1/sites/{site_id}/articles/generate
Content-Type: application/json

{
  "keyword_id": "kw_01hy3..."
}

The response is immediate with a generation job ID. Poll GET /v1/articles/{article_id} every 5 seconds until the status changes from "generating" to "draft" (typically 20–45 seconds).

PreviousKeywords Next Search Console