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. The studio features call the Blogsmith service (blogsmith.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.

External services

This plugin connects to third-party services. The connections below only happen
after you explicitly configure and enable the relevant feature.

1. 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
control panel at 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
the Blogsmith public API at https://blogsmith.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.
Terms of service: https://blogsmith.pro/terms.html
Privacy policy: https://blogsmith.pro/privacy.html

1. 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
oauth2.googleapis.com (authentication) and searchconsole.googleapis.com (URL
inspection).
Google API Terms of Service: https://developers.google.com/terms
Google Privacy Policy: https://policies.google.com/privacy

1. 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
storage provider you choose (for Cloudflare R2: https://www.cloudflare.com/terms/
and https://www.cloudflare.com/privacypolicy/).

API Documentation

All API endpoints are available at: https://your-site.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