Blog API Documentation
ai-blog
api > blog-requests > list
API endpoint for AI blog requests
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
page | A page number within the paginated result set. |
search | A search term. |
ordering | Which field to use when ordering the results. |
api > blog-requests > create
API endpoint for AI blog requests
Request Body
The request body should be a "application/json"
encoded object, containing the following items.
Parameter | Description |
---|---|
title required | The title for the blog post |
topic required | Main topic of the blog |
keywords required | SEO keywords separated by commas |
description required | Brief description of what the blog should cover |
tone | Tone of the blog (professional, casual, technical, etc.) |
target_audience | Target audience for the blog |
word_count | Target word count for the generated blog |
project required | |
category | |
tags | |
temperature | Controls randomness (0.0-1.0) |
max_tokens | Maximum tokens for AI response |
include_faqs | Include FAQ section in the generated blog |
include_table_of_contents | Include table of contents in the generated blog |
image_prompt | Optional master prompt for all images. If left blank, the AI will create custom prompts for each image. |
image_aspect_ratio | Aspect ratio for generated images |
api > blog-requests > read
API endpoint for AI blog requests
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | A unique integer value identifying this AI Blog Request. |
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
search | A search term. |
ordering | Which field to use when ordering the results. |
api > blog-requests > update
API endpoint for AI blog requests
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | A unique integer value identifying this AI Blog Request. |
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
search | A search term. |
ordering | Which field to use when ordering the results. |
Request Body
The request body should be a "application/json"
encoded object, containing the following items.
Parameter | Description |
---|---|
title required | The title for the blog post |
topic required | Main topic of the blog |
keywords required | SEO keywords separated by commas |
description required | Brief description of what the blog should cover |
tone | Tone of the blog (professional, casual, technical, etc.) |
target_audience | Target audience for the blog |
word_count | Target word count for the generated blog |
project required | |
category | |
tags | |
temperature | Controls randomness (0.0-1.0) |
max_tokens | Maximum tokens for AI response |
include_faqs | Include FAQ section in the generated blog |
include_table_of_contents | Include table of contents in the generated blog |
image_prompt | Optional master prompt for all images. If left blank, the AI will create custom prompts for each image. |
image_aspect_ratio | Aspect ratio for generated images |
api > blog-requests > partial_update
API endpoint for AI blog requests
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | A unique integer value identifying this AI Blog Request. |
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
search | A search term. |
ordering | Which field to use when ordering the results. |
Request Body
The request body should be a "application/json"
encoded object, containing the following items.
Parameter | Description |
---|---|
title | The title for the blog post |
topic | Main topic of the blog |
keywords | SEO keywords separated by commas |
description | Brief description of what the blog should cover |
tone | Tone of the blog (professional, casual, technical, etc.) |
target_audience | Target audience for the blog |
word_count | Target word count for the generated blog |
project | |
category | |
tags | |
temperature | Controls randomness (0.0-1.0) |
max_tokens | Maximum tokens for AI response |
include_faqs | Include FAQ section in the generated blog |
include_table_of_contents | Include table of contents in the generated blog |
image_prompt | Optional master prompt for all images. If left blank, the AI will create custom prompts for each image. |
image_aspect_ratio | Aspect ratio for generated images |
api > blog-requests > delete
API endpoint for AI blog requests
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | A unique integer value identifying this AI Blog Request. |
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
search | A search term. |
ordering | Which field to use when ordering the results. |
api > blog-requests > generate
API endpoint to generate a blog
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | A unique integer value identifying this AI Blog Request. |
Request Body
The request body should be a "application/json"
encoded object, containing the following items.
Parameter | Description |
---|---|
title required | The title for the blog post |
topic required | Main topic of the blog |
keywords required | SEO keywords separated by commas |
description required | Brief description of what the blog should cover |
tone | Tone of the blog (professional, casual, technical, etc.) |
target_audience | Target audience for the blog |
word_count | Target word count for the generated blog |
project required | |
category | |
tags | |
temperature | Controls randomness (0.0-1.0) |
max_tokens | Maximum tokens for AI response |
include_faqs | Include FAQ section in the generated blog |
include_table_of_contents | Include table of contents in the generated blog |
image_prompt | Optional master prompt for all images. If left blank, the AI will create custom prompts for each image. |
image_aspect_ratio | Aspect ratio for generated images |
api > blog-requests > status
API endpoint to check blog generation status
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | A unique integer value identifying this AI Blog Request. |
api > generated-images > list
API endpoint for generated images
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
page | A page number within the paginated result set. |
search | A search term. |
ordering | Which field to use when ordering the results. |
api > generated-images > read
API endpoint for generated images
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | A unique integer value identifying this generated image. |
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
search | A search term. |
ordering | Which field to use when ordering the results. |
api
blogs > list
API endpoint for listing blogs
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
page | A page number within the paginated result set. |
search | A search term. |
ordering | Which field to use when ordering the results. |
blogs > read
API endpoint for retrieving a specific blog
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
slug required |
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
search | A search term. |
ordering | Which field to use when ordering the results. |
blogs > analysis > list
Endpoint to get SEO analysis for a blog post
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
slug required |
blogs > canonical > list
Endpoint to get canonical URL for a blog post, useful for handling redirects
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
slug required |
blogs > related > list
Get related content for a blog post based on tags, category, and explicitly set relations
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
slug required |
categories > list
API endpoint for categories
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
page | A page number within the paginated result set. |
search | A search term. |
categories > read
API endpoint for categories
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
slug required |
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
search | A search term. |
categories > blogs > list
API endpoint for listing blogs by category
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
slug required |
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
page | A page number within the paginated result set. |
search | A search term. |
ordering | Which field to use when ordering the results. |
popular > list
Get popular blogs, optionally filtered by project This is a placeholder - in a real implementation, this would factor in view counts, social shares, and other metrics to determine popularity
popular > project > read
Get popular blogs, optionally filtered by project This is a placeholder - in a real implementation, this would factor in view counts, social shares, and other metrics to determine popularity
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
project_slug required |
projects > list
API endpoint for projects
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
page | A page number within the paginated result set. |
search | A search term. |
projects > read
API endpoint for projects
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
slug required |
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
search | A search term. |
projects > stats
Returns statistics for a project
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
slug required |
projects > stats_0
Returns statistics for a project
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
slug required |
projects > blogs > list
API endpoint for listing blogs by project
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
slug required |
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
page | A page number within the paginated result set. |
search | A search term. |
ordering | Which field to use when ordering the results. |
tags > list
API endpoint for tags
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
page | A page number within the paginated result set. |
search | A search term. |
tags > read
API endpoint for tags
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
slug required |
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
search | A search term. |
tags > blogs > list
API endpoint for listing blogs by tag
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
slug required |
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
page | A page number within the paginated result set. |
search | A search term. |
ordering | Which field to use when ordering the results. |