Skip to main content
BlogBotz Logo
Developer Resources

API & Developer Documentation

Integrate BlogBotz into your workflow with our REST API, webhooks, and platform-specific plugins

Authentication
REST API
Webhooks
Plugins & SDKs
Authentication

API Authentication

All API requests require authentication via a Bearer token. You can generate an API key from your BlogBotz dashboard under Settings → API Keys.

HTTP Header Required 
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Accept: application/json

Security Best Practices

  • Never expose your API key in client-side code or public repositories
  • Use environment variables to store API keys on your server
  • Rotate your API keys periodically from the dashboard
  • All API requests are made over HTTPS
REST API

REST API Endpoints

Base URL: https://blogbotz.com/api/v1

POST /blogs/generate Generate a new blog post

Generate a new AI-powered blog post on a given topic. The blog will be queued for generation and published to your connected website.

Request Body

{
  "topic": "10 Best Productivity Apps for Remote Workers",
  "website_id": 42,
  "language": "en",
  "tone": "professional",
  "word_count": 2000,
  "auto_publish": true,
  "generate_image": true,
  "schedule_at": "2026-04-01T09:00:00Z"
}

Response

{
  "success": true,
  "data": {
    "blog_id": 1284,
    "status": "queued",
    "topic": "10 Best Productivity Apps for Remote Workers",
    "estimated_completion": "2026-03-23T14:30:00Z",
    "credits_used": 1
  }
}
GET /blogs List all blog posts

Retrieve a paginated list of all generated blog posts for your account.

Query Parameters

Parameter Type Description
page integer Page number (default: 1)
per_page integer Results per page (default: 20, max: 100)
status string Filter by status: queued, generating, published, failed
website_id integer Filter by connected website
GET /blogs/{id} Get blog details

Retrieve full details of a specific blog post including content, meta data, SEO score, and publish status.

Response

{
  "success": true,
  "data": {
    "id": 1284,
    "topic": "10 Best Productivity Apps for Remote Workers",
    "status": "published",
    "content": "<h2>Introduction</h2><p>...</p>",
    "meta_title": "10 Best Productivity Apps for Remote Workers (2026)",
    "meta_description": "Discover the top productivity apps...",
    "featured_image_url": "https://...",
    "word_count": 2145,
    "seo_score": 92,
    "published_at": "2026-03-23T14:32:00Z",
    "website": {
      "id": 42,
      "name": "My WordPress Blog",
      "platform": "wordpress"
    }
  }
}
GET /websites List connected websites

Retrieve all websites connected to your BlogBotz account, including platform type, connection status, and blog count.

GET /account/credits Check credit balance

Check your current credit balance and usage history.

{
  "success": true,
  "data": {
    "credits_remaining": 47,
    "credits_used_this_month": 23,
    "total_credits_purchased": 350
  }
}
Webhooks

Webhook Events

Receive real-time notifications when events occur in your BlogBotz account. Configure webhook URLs from Settings → Webhooks in your dashboard.

blog.generated

Fired when a blog post has been successfully generated and is ready for review or publishing.

{
  "event": "blog.generated",
  "blog_id": 1284,
  "topic": "10 Best Productivity Apps",
  "status": "ready",
  "timestamp": "2026-03-23T14:30:00Z"
}

blog.published

Fired when a blog post has been successfully published to your connected website.

{
  "event": "blog.published",
  "blog_id": 1284,
  "website_id": 42,
  "published_url": "https://example.com/blog/productivity-apps",
  "timestamp": "2026-03-23T14:32:00Z"
}

blog.failed

Fired when a blog post fails to generate or publish. Includes error details for debugging.

{
  "event": "blog.failed",
  "blog_id": 1285,
  "error": "Website connection timeout",
  "retry_available": true,
  "timestamp": "2026-03-23T14:35:00Z"
}

credits.low

Fired when your credit balance drops below the threshold you set in your account settings.

Integrations

Plugins & Platform Integrations

Ready-made integrations for popular platforms

WordPress Plugin

Install the BlogBotz plugin directly from WordPress. Auto-publish posts, sync categories, and manage content from your WP dashboard.

Available

Shopify Integration

Connect your Shopify store via the BlogBotz dashboard. Publish blog posts, product guides, and category content directly.

Available

OpenCart Extension

Custom BlogBotz extension for OpenCart 3.x and 4.x. Install via the extension installer and connect to your BlogBotz account.

Available

Wix Integration

Connect your Wix site via API key. BlogBotz publishes blog posts directly to your Wix blog with full formatting support.

Available

Webhook (Any Platform)

Use webhooks to receive generated content on any platform. BlogBotz sends the full blog payload to your endpoint for custom handling.

Available

REST API

Full REST API access for custom integrations. Generate blogs, manage topics, check credits, and more from your own application.

Available

Rate Limits & Errors

Rate Limits

  • 60 requests per minute for read endpoints (GET)
  • 10 requests per minute for write endpoints (POST/PUT/DELETE)
  • Rate limit headers included in every response
  • 429 status returned when limits are exceeded

Error Codes

  • 401 Invalid or missing API key
  • 402 Insufficient credits
  • 404 Resource not found
  • 422 Validation error (check request body)
  • 429 Rate limit exceeded
  • 500 Internal server error

Start Building with BlogBotz

Create a free account to get your API key and start integrating

Get API Key Contact Support