RankBot API v1.

Drive the full publishing pipeline from your own backend. RESTful, JSON in/out, predictable rate limits.

Authentication

Every request requires an X-RankBot-Key header. Generate keys in Dashboard → Settings → API.

curl https://api.rankbot.pro/rankbot/v1/posts \
  -H "X-RankBot-Key: rb_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"best espresso machines","site_id":"site_abc"}'

Endpoints

POST/rankbot/v1/posts

Generate and publish a new article. Optionally schedule, set draft mode, or attach partner backlinks.

GET/rankbot/v1/posts/:id

Fetch a generated post including SEO score, image URLs, and WordPress publish status.

POST/rankbot/v1/images

Generate a standalone featured image from a prompt. Returns CDN URL.

GET/rankbot/v1/sites

List connected WordPress sites with health status.

POST/rankbot/v1/sites/:id/categories

Create or update WordPress categories synced with RankBot.

POST/rankbot/v1/seo/meta

Push Yoast or RankMath meta (focus keyword, meta title, description) to any WP post.

GET/rankbot/v1/keywords

Pull keyword suggestions with volume and difficulty for a given seed.

Rate limits

120 requests/min on Pro, 600 requests/min on Agency. Generation endpoints count as 5 requests each.