API Reference

The SEObox REST API lets you list your sites and articles, start article generation from your own systems, and receive event webhooks when things happen.

Base URL


https://api.seobox.tech/v1/api

All requests and responses use JSON.

Authentication

Create a key in the dashboard under Settings → API → API key → Generate key. The key is shown once — copy it somewhere safe.

Send it in the x-api-key header on every request:


curl https://api.seobox.tech/v1/api/sites \
  -H "x-api-key: $SEOBOX_API_KEY"

Each account has one API key, with read and write access.
Rotate key issues a new key and immediately revokes the old one. Revoke turns API access off.
Only account owners and admins can manage the key.

The key has full read and write access to your account. Keep it on your server. Never put it in browser code or a mobile app.

Workspace header

Article endpoints work inside a workspace. Send the workspace’s ID in the x-workspace-id header:


curl "https://api.seobox.tech/v1/api/blogs" \
  -H "x-api-key: $SEOBOX_API_KEY" \
  -H "x-workspace-id: 66f1c2a9e4b0a1b2c3d4e5f6"

Without it, those endpoints return 400 with “Provide x-workspace-id header for this endpoint”. Individual accounts have a single workspace; agency accounts have one per client. To get your workspace ID, contact SEObox support.

Endpoints

Method	Path	Needs `x-workspace-id`	Description
`GET`	`/sites`	No	List your sites
`GET`	`/blogs`	Yes	List articles, newest first
`GET`	`/blogs/{uid}`	Yes	Get one article with its full content
`POST`	`/generate`	Yes	Start generating an article

IDs

uid values (site and article) are UUIDs, e.g. 3f2b8c1e-7d4a-4f6b-9c2e-1a5d8e9f0b3c.
_id values are 24-character hex strings. They’re used as pagination cursors and workspace IDs.

Limits and errors

60 requests per minute per key. See Errors & Rate Limits.