# SEO Beast Public Content API

SEO Beast (https://seobeast.io) is an SEO automation platform that doubles as a
headless CMS. Published blog content is served from a fast, public, no-auth
REST API so any site can host its blog on SEO Beast without running WordPress.

## Base URL

https://api.seobeast.io/v1/public

## Authentication

None. All endpoints are public and return published content only.

## Endpoints

- GET /{websiteSlug}/posts — paginated list of published posts.
  Query params: page, limit (max 50), category, tag, search (min 2 chars),
  sort (published_at | title | view_count), order (asc | desc)
- GET /{websiteSlug}/posts/{slug} — single post with full content
- GET /{websiteSlug}/categories — all categories with post counts
- GET /{websiteSlug}/tags — all tags with post counts
- GET /{websiteSlug}/feeds/rss — RSS feed
- GET /{websiteSlug}/posts/{slug}/comments — approved comments for a post

## Response envelope

All endpoints return JSON:
{ "success": true, "data": { ... } }
List endpoints include data.posts and data.pagination
(page, limit, totalPages, totalItems).

## Integration notes

- Content is available the moment a post is published; cache with ISR or
  short TTLs (e.g. revalidate every 600s).
- Post objects include title, slug, contentHtml, excerpt, featured image URL,
  SEO metadata (seoTitle, seoDescription), author, category, tags, and dates.
- Works with any stack: Next.js, Astro, Nuxt, SvelteKit, or plain fetch.

## Full documentation

https://seobeast.io/docs/api