Blogsmith API

Blogsmith is an AI content studio for WordPress. Connect your site to the Blogsmith service and write, optimize and publish blog content — without leaving your dashboard.

The plugin adds a “Blogsmith” studio to wp-admin where you can:

• Write articles with AI — give a title, brief and target keywords, pick a model, language and target-market region, and generate a ready-to-edit draft.

• Generate images — create a featured image or standalone artwork and save it straight to your media library.

• Research keywords — real search volume, difficulty, CPC and intent (powered by DataForSEO), then turn a keyword into an article in one click.

• Brainstorm ideas — get suggested article topics and blog categories, and add the categories to your site.

• Bulk-generate — paste a list of topics and produce many articles at once, saved as drafts or scheduled across days.

• Create authors — generate an author persona (name, bio and optional portrait) and add it as a WordPress user.

• Review and publish — in-plugin readability and SEO guidance, editable SEO meta and tags, then publish, schedule, save as a draft, or hand off to the block editor.

Under the hood the plugin also exposes a secure, API-key-authenticated REST API so the Blogsmith service can publish and manage posts, authors, categories, tags, media and custom post types on your site — including across a multisite network.

A Blogsmith account is required. pro) using the account you connect on the Settings screen, and content generation is billed to your Blogsmith balance. One-click pairing connects your site — there are no API keys to copy.

See the External services section below for exactly what is sent and when.

Translations: the studio ships with Spanish (es_ES, es_MX, es_US) and Russian (ru_RU) and is fully translation-ready.

Older WordPress or PHP? 0 or newer. pro/downloads — it keeps you running until you can update.

External services

This plugin connects to third-party services. The connections below only happen

after you explicitly configure and enable the relevant feature.

• Blogsmith content management service (blogsmith.pro)

This plugin is the WordPress client for the Blogsmith content management service.

Blogsmith authenticates to this site’s REST API (using the API key shown on the

plugin’s settings page) to publish and manage posts, authors, categories, tags,

media and structured data. The plugin’s admin pages also link to your Blogsmith

pro. Site data (post content, authors, media, system

information) is exchanged with Blogsmith when you use the service.

In addition, the content-generation studio (the “Blogsmith” admin screen) calls

pro/api/v1 on your behalf, using the

account API key you enter on the Settings screen. These outbound requests happen

only after you enter a key and use the studio: they read your account balance and

available models, create and poll article-generation tasks (the title, brief and

keywords you provide are sent), and download generated images. No requests are

made to this endpoint until you configure a key.

html

html

• Google Search Console API (googleapis.com)

Used only when the optional “Google Indexation” feature is enabled and you have

supplied a Google service account key. The plugin sends the URLs of your

published posts to Google to check their indexation status. Requests go to

com (URL

inspection).

com/terms

com/privacy

• S3-compatible object storage / Cloudflare R2 (user-defined endpoint)

Used only when the optional “S3 Storage” feature is enabled. Images you upload

through the plugin are sent to the S3-compatible endpoint, bucket and credentials

that you configure on the Storage settings page. No data is sent to this service

until you enable and configure it. Review the terms and privacy policy of the

com/terms/

com/privacypolicy/).

API Documentation

com/wp-json/blogsmith/v1/

Authentication:

Include your API key in the X-API-Key header with every request.

Available Endpoints:

• GET /health – Check API status and plugin version (no authentication required)

• GET /system-info – Environment diagnostics: PHP/WordPress/database versions, server, limits (API key required)

• GET /websites – List all websites

• POST /keys/rotate – Rotate API key

• GET /categories – Get all categories

• POST /categories – Create/update categories

• POST /topics – Create a new post

• GET /topics/{id} – Get a post

• PUT /topics/{id} – Update a post

• DELETE /topics/{id} – Delete a post

• GET /authors – List all authors

• POST /authors – Create an author

• GET /authors/{id} – Get an author

• PUT /authors/{id} – Update an author

• GET /structured – Get available custom post types

• POST /structured – Create structured content

• GET /structured/{id} – Get structured content

• PUT /structured/{id} – Update structured content

• DELETE /structured/{id} – Delete structured content