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, pausedAdd 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"
}