DocsAPI Reference

API

API Reference

Complete reference for all AI Blog Studio API endpoints.

Base URL

https://api.aiblogstudio.com/v1

POST/api/v1/generate

Generate Blog Post

Generate a complete blog post using AI based on your topic and preferences.

Request

{
  "topic": "string (required)",
  "industry": "string (optional)",
  "tone": "professional | casual | friendly",
  "length": "short | medium | long",
  "language": "en | zh | es | fr | de | ja"
}

Response

{
  "id": "blog_abc123",
  "title": "Generated Title",
  "content": "Full blog content...",
  "meta_description": "SEO description",
  "tags": ["tag1", "tag2"],
  "reading_time": 5,
  "created_at": "2025-01-15T10:30:00Z"
}

GET/api/v1/blogs

List Blog Posts

Retrieve a paginated list of all your blog posts.

Request

Query Parameters:
  page: number (default: 1)
  limit: number (default: 10, max: 100)
  status: draft | published | all

Response

{
  "data": [
    { "id": "blog_abc123", "title": "...", ... }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 42,
    "total_pages": 5
  }
}

GET/api/v1/blogs/:id

Get Blog Post

Retrieve a specific blog post by its ID.

Request

Path Parameters:
  id: string (required) - The blog post ID

Response

{
  "id": "blog_abc123",
  "title": "Blog Title",
  "content": "Full content...",
  "status": "published",
  "created_at": "2025-01-15T10:30:00Z",
  "updated_at": "2025-01-15T10:30:00Z"
}

PUT/api/v1/blogs/:id

Update Blog Post

Update an existing blog post.

Request

{
  "title": "string (optional)",
  "content": "string (optional)",
  "status": "draft | published (optional)",
  "tags": ["array", "optional"]
}

Response

{
  "id": "blog_abc123",
  "title": "Updated Title",
  "content": "Updated content...",
  "updated_at": "2025-01-15T11:00:00Z"
}

DELETE/api/v1/blogs/:id

Delete Blog Post

Permanently delete a blog post.

Request

Path Parameters:
  id: string (required) - The blog post ID

Response

{
  "success": true,
  "message": "Blog post deleted successfully"
}

POST/api/v1/images

Generate AI Image

Generate an AI image for your blog post.

Request

{
  "prompt": "string (required)",
  "style": "photorealistic | illustration | abstract",
  "aspect_ratio": "1:1 | 16:9 | 4:3"
}

Response

{
  "id": "img_xyz789",
  "url": "https://cdn.aiblogstudio.com/...",
  "width": 1920,
  "height": 1080,
  "created_at": "2025-01-15T10:31:00Z"
}

DocsAPI Reference

API

API Reference

Complete reference for all AI Blog Studio API endpoints.

Base URL

https://api.aiblogstudio.com/v1

POST/api/v1/generate

Generate Blog Post

Generate a complete blog post using AI based on your topic and preferences.

Request

{
  "topic": "string (required)",
  "industry": "string (optional)",
  "tone": "professional | casual | friendly",
  "length": "short | medium | long",
  "language": "en | zh | es | fr | de | ja"
}

Response

{
  "id": "blog_abc123",
  "title": "Generated Title",
  "content": "Full blog content...",
  "meta_description": "SEO description",
  "tags": ["tag1", "tag2"],
  "reading_time": 5,
  "created_at": "2025-01-15T10:30:00Z"
}

GET/api/v1/blogs

List Blog Posts

Retrieve a paginated list of all your blog posts.

Request

Query Parameters:
  page: number (default: 1)
  limit: number (default: 10, max: 100)
  status: draft | published | all

Response

{
  "data": [
    { "id": "blog_abc123", "title": "...", ... }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 42,
    "total_pages": 5
  }
}

GET/api/v1/blogs/:id

Get Blog Post

Retrieve a specific blog post by its ID.

Request

Path Parameters:
  id: string (required) - The blog post ID

Response

{
  "id": "blog_abc123",
  "title": "Blog Title",
  "content": "Full content...",
  "status": "published",
  "created_at": "2025-01-15T10:30:00Z",
  "updated_at": "2025-01-15T10:30:00Z"
}

PUT/api/v1/blogs/:id

Update Blog Post

Update an existing blog post.

Request

{
  "title": "string (optional)",
  "content": "string (optional)",
  "status": "draft | published (optional)",
  "tags": ["array", "optional"]
}

Response

{
  "id": "blog_abc123",
  "title": "Updated Title",
  "content": "Updated content...",
  "updated_at": "2025-01-15T11:00:00Z"
}

DELETE/api/v1/blogs/:id

Delete Blog Post

Permanently delete a blog post.

Request

Path Parameters:
  id: string (required) - The blog post ID

Response

{
  "success": true,
  "message": "Blog post deleted successfully"
}

POST/api/v1/images

Generate AI Image

Generate an AI image for your blog post.

Request

{
  "prompt": "string (required)",
  "style": "photorealistic | illustration | abstract",
  "aspect_ratio": "1:1 | 16:9 | 4:3"
}

Response

{
  "id": "img_xyz789",
  "url": "https://cdn.aiblogstudio.com/...",
  "width": 1920,
  "height": 1080,
  "created_at": "2025-01-15T10:31:00Z"
}