Blog Topics

AI-powered blog topic suggestion and content planning endpoints

Generate blog topic suggestions

post

Generate contextual blog topic suggestions based on project information and optional user prompt

Authorizations
Body
promptstringOptional

Optional user prompt to guide topic suggestions

Example: I want to write about AI integration challenges
number_of_topicsinteger ยท min: 1 ยท max: 10Optional

Number of topic suggestions to generate

Default: 3
include_project_contextbooleanOptional

Whether to include project context in the response

Default: false
Responses
200

Successfully generated blog topic suggestions

application/json
post
POST /api/blog/suggest-topics HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 113

{
  "prompt": "I want to write about AI integration challenges",
  "number_of_topics": 3,
  "include_project_context": false
}
{
  "success": true,
  "suggestions": [
    {
      "title": "text",
      "description": "text",
      "audience": "text",
      "difficulty": "beginner",
      "estimated_read_time": "text",
      "keywords": [
        "text"
      ],
      "content_outline": [
        "text"
      ],
      "relevant_links": [
        {
          "link": "text",
          "description": "text"
        }
      ],
      "project_features_to_highlight": [
        "text"
      ]
    }
  ],
  "project_context": {},
  "total_suggestions": 1,
  "generated_at": "2025-09-01T11:48:50.351Z"
}

Get project context information

get

Retrieve detailed information about the project extracted from CLAUDE.md

Authorizations
Responses
200

Successfully retrieved project context

No content

get
GET /api/blog/project-context HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer JWT
Accept: */*

No content

Health check for blog suggestion service

get

Check if the blog topic suggestion service is operational

Responses
200

Service is healthy

No content

get
GET /api/blog/health HTTP/1.1
Host: api.autocontentapi.com
Accept: */*

No content