Developers

The Autoranko API

Everything the dashboard does, as an API: create articles from a topic, read every result, run keyword research, switch AI models, and get signed webhooks when content ships. Base URL https://autoranko.com/api/public/v1 · OpenAPI spec.

Authentication

Create a token in Dashboard → API and send it as a bearer header. Tokens are shown once and can be revoked anytime. Rate limit: 120 requests/minute per token (see the X-RateLimit-* response headers).

curl https://autoranko.com/api/public/v1/me \
  -H "Authorization: Bearer ar_live_..."

Quickstart: topic → published article

# 1. Find your site id
curl https://autoranko.com/api/public/v1/sites -H "Authorization: Bearer $TOKEN"

# 2. Create a generation job (starts immediately; add "scheduled_for" to queue it)
curl -X POST https://autoranko.com/api/public/v1/sites/1/jobs \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"topic": "How to winterize a sprinkler system", "target_keyword": "winterize sprinkler system"}'

# 3. Poll until status is "review" (or receive the job.review webhook)
curl https://autoranko.com/api/public/v1/jobs/42 -H "Authorization: Bearer $TOKEN"

# 4. Approve → publishes to your connected WordPress site
curl -X POST https://autoranko.com/api/public/v1/jobs/42/publish -H "Authorization: Bearer $TOKEN"

Endpoints

Webhooks

Add endpoints in Dashboard → API. Events: job.review (article generated, awaiting approval), job.published, job.failed. Each delivery is signed — verify it like this:

// X-Autoranko-Signature: sha256=<hex>
import { createHmac, timingSafeEqual } from "node:crypto";

function verify(rawBody, header, secret) {
  const expected = "sha256=" + createHmac("sha256", secret).update(rawBody).digest("hex");
  return timingSafeEqual(Buffer.from(expected), Buffer.from(header));
}

Errors

Non-2xx responses return {"error": {"code", "message"}}. Codes: missing_token, invalid_token, rate_limited (with Retry-After), not_found, invalid_body, plan_limit, invalid_state, forbidden, upstream_error.