# SuprSonic API Documentation

## Docs

- [List all accounts with subscription and entitlements](https://docs.suprsonic.com/api-reference/accounts/list-all-accounts.md): Retrieve a paginated list of all accounts with their subscription status, plan entitlements, and content generation eligibility. Requires admin authentication. Provides all business logic needed for content generation systems.
- [Create a new article](https://docs.suprsonic.com/api-reference/articles/create-article.md): Create a new article. Currently requires admin API key for access. - **Admin API keys**: Must provide account_id in request body, can create articles for any account
- [Get a single article by ID or slug](https://docs.suprsonic.com/api-reference/articles/get-article.md): Retrieve a single article by its UUID or slug. The article access is determined by the authentication:
- [Get related articles](https://docs.suprsonic.com/api-reference/articles/get-related-articles.md): Retrieve articles related to the specified article based on tag overlap and category matching. Returns article preview data without content.
- [List articles](https://docs.suprsonic.com/api-reference/articles/list-articles.md): Retrieve a paginated list of articles with filtering and search options. The articles returned depend on the authentication used:
- [Get all categories](https://docs.suprsonic.com/api-reference/categories/list-categories.md): Retrieve a list of all article categories used by the account with their usage counts. The categories returned depend on the authentication used:
- [Generate article idea with content prompt](https://docs.suprsonic.com/api-reference/content/generate-article-idea.md): Generate an intelligent article idea with targeted keywords and return a clean XML prompt for third-party content generation systems.
- [API Reference](https://docs.suprsonic.com/api-reference/introduction.md): Complete reference for the SuprSonic API endpoints
- [Get SEO content](https://docs.suprsonic.com/api-reference/seo/get-seo-content.md): Returns SEO content in various formats (sitemap, rss, robots, llm, atom) for the authenticated account
- [Get account settings, branding, and customer avatars](https://docs.suprsonic.com/api-reference/settings/get-account-settings.md): Returns comprehensive account configuration including settings, branding, and customer personas for blog rendering and content generation
- [Get all tags](https://docs.suprsonic.com/api-reference/tags/list-tags.md): Retrieve all tags used in articles. The tags returned depend on the authentication used:
- [Authentication](https://docs.suprsonic.com/authentication.md): Learn how to authenticate with the SuprSonic API
- [Error Handling](https://docs.suprsonic.com/guides/errors.md): Understanding API errors and responses
- [Pagination](https://docs.suprsonic.com/guides/pagination.md): How to paginate through API results
- [Rate Limits](https://docs.suprsonic.com/guides/rate-limits.md): Understanding API rate limits
- [Introduction](https://docs.suprsonic.com/introduction.md): Welcome to the SuprSonic API documentation
- [Quickstart](https://docs.suprsonic.com/quickstart.md): Get started with the SuprSonic API in minutes

## OpenAPI Specs

- [openapi](https://docs.suprsonic.com/openapi.json)