Skip to content Skip to footer

API Documentation

Base URL

https://dash.autoblogging.ai/api/v1

Authentication

All API requests require authentication using an API key and dashboard email.

Endpoints

1. Create Article

Creates a new article based on the provided parameters.

  • URL: /articles
  • Method: POST
  • Content-Type: application/json

Request Body

Important Note: All fields in the request body must be provided. If a field is not applicable, use the default value specified in the table below.

Field Type Description Default
dashboard_email string The email associated with the dashboard account N/A (Required)
api_key string The API key for authentication N/A (Required)
request_type string Must be set to “create_article” N/A (Required)
title string The main topic or title of the blog post N/A (Required)
project_name string Name of the project Empty string
language string The language of the article. Options: English, EnglishUK, Arabic, Bulgarian, Chinese, Danish, Dutch, Estonian, Finnish, French, German, Greek, Hindi, Hungarian, Indonesian, Italian, Japanese, Korean, Latvian, Lithuanian, Norwegian, Polish, Portuguese, Portuguese_BR, Romanian, Russian, Slovak, Slovenian, Spanish, Swedish, Turkish, Vietnamese English
length string Article length. Options: short, medium, long medium
tone_of_voice string Tone of the article. Options: first-person, second-person, third-person third-person
writing_style string Writing style. Options: premium_writing_style_1, Conversational, Professional, Witty Professional
type_of_article string Type of article. Options: Informative, listicle, places Informative
faqs string Whether to include FAQs. Options: yes, no no
imagegeneration string Whether to generate images. Options: yes, no no
godlikemode string Whether to use godlike mode. Options: yes, no no
serp_location string SERP location code (2-letter country code, e.g., “us” for United States) us
outlinefromcompetition string Whether to use outline from competition. Options: yes, no no
keytakeaways string Whether to include key takeaways. Options: yes, no no
externallinks string Whether to include external links. Options: yes, no no
videoembed string Whether to embed videos. Options: yes, no no
source_context string Additional context for the article (max 300 characters) na
wordpresspush string Whether to push to WordPress. Options: yes, no no
wp_siteurl string WordPress site URL (required if wordpresspush is yes) Empty string
wp_username string WordPress username (required if wordpresspush is yes) Empty string
wp_password string WordPress password (required if wordpresspush is yes) Empty string
wp_category string WordPress category (comma-separated if multiple) Empty string
wp_status string WordPress post status. Options: publish, draft draft
wp_customtext string Custom text for WordPress in HTML format na
applyautogenerateslugs string Whether to auto-generate slugs. Options: yes, no no
applyautogeneratetitles string Whether to auto-generate titles. Options: yes, no no
combotpush string Whether to use Combot push. Options: yes, no no
combot_triggerid string Combot trigger ID na
intense_optimize string Whether to use intense optimization. Options: yes, no no
ai_proofreader string Whether to use AI proofreading. Options: yes, no no
proofreading_guidelines string Guidelines for proofreading (required if ai_proofreader is yes, max 3000 characters) na

Response

  • Success Response:
    • Code: 200
    • Content:
    {
      "status": "success",
      "article_id": "<url_token>"
    }
  • Error Responses:
    • Code: 400
    • Content: Various error messages depending on the validation failure
    • Code: 401
    • Content:
    {
      "error": "Invalid API key or email"
    }
    • Code: 404
    • Content:
    {
      "error": "User not found"
    }

Example cURL Request

curl -X POST https://dash.autoblogging.ai/api/v1/articles 
  -H "Content-Type: application/json" 
  -d '{
    "dashboard_email": "[email protected]",
    "api_key": "your_api_key_here",
    "request_type": "create_article",
    "title": "The Impact of Artificial Intelligence on Modern Business",
    "project_name": "AI in Business",
    "language": "English",
    "length": "medium",
    "tone_of_voice": "third-person",
    "writing_style": "Professional",
    "type_of_article": "Informative",
    "faqs": "yes",
    "imagegeneration": "yes",
    "godlikemode": "no",
    "serp_location": "us",
    "outlinefromcompetition": "yes",
    "keytakeaways": "yes",
    "externallinks": "yes",
    "videoembed": "no",
    "source_context": "Focus on recent AI advancements and their practical applications in various industries",
    "wordpresspush": "no",
    "wp_siteurl": "",
    "wp_username": "",
    "wp_password": "",
    "wp_category": "",
    "wp_status": "draft",
    "wp_customtext": "na",
    "applyautogenerateslugs": "no",
    "applyautogeneratetitles": "no",
    "combotpush": "no",
    "combot_triggerid": "na",
    "intense_optimize": "yes",
    "ai_proofreader": "yes",
    "proofreading_guidelines": "Ensure technical terms are accurately used and explained. Check for consistent formatting of company names and AI-related acronyms."
  }'

2. Fetch Article

Retrieves a generated article by its URL token.

  • URL: /articles
  • Method: POST
  • Content-Type: application/json

Request Body

Field Type Description
dashboard_email string The email associated with the dashboard account
api_key string The API key for authentication
request_type string Must be set to “fetch_article”
url_token string The unique token of the article to fetch

Response

  • Success Response:
    • Code: 200
    • Content:
    {
      "final_title": "Article Title",
      "final_article": "Full article content..."
    }
  • Error Response:
    • Code: 404
    • Content:
    {
      "error": "Article not found or not yet generated"
    }

Example cURL Request

curl -X POST https://dash.autoblogging.ai/api/v1/articles 
  -H "Content-Type: application/json" 
  -d '{
    "dashboard_email": "[email protected]",
    "api_key": "your_api_key_here",
    "request_type": "fetch_article",
    "url_token": "abcdefghijklmn"
  }'

Notes

  • Ensure all required fields are provided in the request body. If a field is not applicable, use the default value specified in the table.
  • The API uses credits for article creation. Make sure you have sufficient credits before making requests.
  • Some fields like godlikemode, intense_optimize, and ai_proofreader may consume additional credits.
  • WordPress integration is optional. If you don’t want to use it