Docs
Api
Keywords

Keywords API

Read and manage the keyword pipeline, import keywords at scale, and queue AI-driven keyword discovery.

List keywords

bash
GET /v1/sites/{site_id}/keywords

# Filter by status
GET /v1/sites/{site_id}/keywords?status=approved

# Available statuses: suggested, approved, generating, published, blocked, paused

Add a keyword

bash
POST /v1/sites/{site_id}/keywords
Content-Type: application/json

{
  "keyword": "best project management software for remote teams",
  "priority": "high"
}
json
{
  "keyword": {
    "id": "kw_01hy3...",
    "keyword": "best project management software for remote teams",
    "status": "approved",
    "volume": 8100,
    "difficulty": 42,
    "priority": "high",
    "createdAt": "2025-07-22T09:00:00Z"
  }
}

Bulk import keywords

Import up to 500 keywords in a single request.

bash
POST /v1/sites/{site_id}/keywords/bulk
Content-Type: application/json

{
  "keywords": [
    "keyword one",
    "keyword two",
    "keyword three"
  ]
}

Block a keyword

bash
PATCH /v1/sites/{site_id}/keywords/{keyword_id}

{
  "status": "blocked"
}