SeoboxSeobox
Developer API v1

Build custom SEO workflows

A powerful, RESTful API that lets you generate, analyze, and publish content programmatically.

quick-start.sh
bash
curl -X POST https://api.seobox.com/v1/generate \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "keyword": "ai seo tools" }'

Authentication

Every request must include your API key as a Bearer token in the Authorization header. Generate and rotate keys from your workspace settings.

Read

Fetch keywords, jobs & reports

Write

Generate, optimize & publish

Admin

Manage keys & webhooks

bash
curl https://api.seobox.com/v1/keywords \
  -H "Authorization: Bearer sk_live_your_key"

Base URL

All endpoints are relative to the base URL below. Every response — success or error — is returned as JSON.

text
https://api.seobox.com/v1

Errors & Rate Limits

Seobox uses conventional HTTP status codes. 2xx codes indicate success, 4xx codes indicate a request problem, 5xx codes indicate an issue on our side.

CodeNameMeaning
400Bad RequestMalformed request body or missing required fields.
401UnauthorizedMissing or invalid API key.
403ForbiddenYour plan does not include this endpoint or scope.
429Too Many RequestsYou have exceeded your rate limit for this plan.
500Server ErrorSomething went wrong on our end — safe to retry.
Rate limits by plan
Starter
60 req / min
10 concurrent jobs
Growth
300 req / min
50 concurrent jobs
Scale
1,200 req / min
Unlimited concurrent jobs
POST/v1/generate

Generate Article

Initiate a new content generation pipeline for a given keyword or topic.

Example Request

bash
curl -X POST https://api.seobox.com/v1/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "AI in marketing",
    "tone": "professional",
    "word_count": 1500
  }'

Example Response

json
{
  "status": "success",
  "data": {
    "job_id": "gen_8x92nd",
    "status": "processing",
    "estimated_completion": "45s"
  }
}
GET/v1/keywords

Keyword Research

Fetch search volume, difficulty, and intent clustering for a seed keyword.

Example Request

bash
curl -X GET https://api.seobox.com/v1/keywords?seed=saas+marketing \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

json
{
  "status": "success",
  "data": [
    {
      "keyword": "b2b saas marketing",
      "volume": 2400,
      "difficulty": 68,
      "intent": "informational"
    }
  ]
}
POST/v1/publish

Publish to CMS

Push an approved article draft directly to your configured CMS integration.

Example Request

bash
curl -X POST https://api.seobox.com/v1/publish \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "article_id": "art_99mx3",
    "integration_id": "int_wp_22"
  }'

Example Response

json
{
  "status": "success",
  "data": {
    "publish_id": "pub_7781k",
    "url": "https://yourblog.com/ai-marketing",
    "status": "live"
  }
}
POST/v1/webhooks

Register Webhook

Subscribe to real-time events when generation, optimization, or publishing jobs complete.

Example Request

bash
curl -X POST https://api.seobox.com/v1/webhooks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://yourapp.com/hooks/seobox",
    "events": ["article.published", "job.completed"]
  }'

Example Response

json
{
  "status": "success",
  "data": {
    "webhook_id": "wh_44jz1",
    "url": "https://yourapp.com/hooks/seobox",
    "active": true
  }
}

Need a hand shipping a custom integration?

Browse our pre-built integrations first — WordPress, Webflow, and more ship with zero code required.

View Integrations
Ready to automate?

Ready to generate SEO content on autopilot?

Stop writing manually. Give Seobox a keyword and watch it research, draft, and publish fully optimized content that ranks and gets cited by AI engines.

Start Free
No credit card required Setup in minutes