About this plugin
Blippinz AI SEO is a lightweight WordPress plugin that bridges your external AI content generation service with your WordPress site. It registers a secure, configurable REST API endpoint that accepts AI-generated articles — including HTML content, titles, and featured images — and creates them as WordPress posts automatically.
This plugin was built for the Blippinz platform, which uses artificial intelligence to generate SEO-optimised articles. Instead of manually copying content from an AI tool into WordPress, Blippinz AI SEO handles the entire publish flow: receive content → upload image → set featured image → create post → go live.
How it works:
- Your AI service (or any HTTP client) sends a POST request to /wp-json/blipaise/v1/addPost
- The request is authenticated using an API key you set in the WordPress admin
- The plugin sanitises and validates all inputs
- It creates the WordPress post with the provided image, title, content, and status
- If an image is included (base64 or file upload), it is uploaded to the Media Library and set as the post’s featured image
- The API returns the new post ID, permalink, and media URL
Key Features:
- Secure API key authentication — All requests to the post creation endpoint must carry a secret key set exclusively by you in WP Admin. No hardcoded defaults.
- Base64 image upload — Send an image as a base64-encoded string in the JSON payload and the plugin automatically decodes, validates, and uploads it to the Media Library.
- Multipart file upload — Alternatively, upload a file directly using multipart/form-data.
- Automatic featured image — Uploaded images are set as the post’s featured image automatically.
- Configurable upload limits — Set the maximum file size (1–50 MB) and allowed MIME types (JPEG, PNG, GIF, WEBP, PDF) from the settings page.
- Full input sanitisation — All fields are sanitised using native WordPress functions ( sanitize_text_field, wp_kses_post, sanitize_key, absint, sanitize_file_name ).
- MIME type validation — File types are verified against the server’s actual file contents using wp_check_filetype_and_ext, not just the filename or client-reported type.
- WordPress-native internationalisation — All user-facing strings use the blippinz-ai-seo text domain and are ready for translation.
Configuration
After activation, go to Settings → Blippinz AI SEO to configure:
Blippinz API Key
The secret key that must be included in every request to the addPost endpoint. g. a UUID or 32-character random hex string).
This key is stored in the WordPress options table and is never exposed in the front-end.
Max Upload Size (MB)
Maximum file size allowed for image uploads via this plugin. Range: 1–50 MB. The effective limit is also capped by your server’s PHP upload_max_filesize setting.
Allowed File Types
Choose which MIME types are accepted for image uploads. Available options: JPEG, PNG, GIF, WEBP, PDF.
REST API Reference
Base URL
com/wp-json/blipaise/v1
Authentication
All requests to the addPost endpoint must be authenticated. There are two methods:
Method 1 — HTTP Header (recommended):
X-BLIPAISE-KEY: your-secret-api-key
Method 2 — Query parameter:
api_key=your-secret-api-key
Requests with a missing, empty, or incorrect key will receive a 401 Unauthorized response.
g. from the WP admin) can also call the endpoint without an API key, provided they have the edit_posts capability.
Endpoints
GET /status
Returns the plugin status. Requires edit_posts capability (logged-in WordPress users only).
Response:
0" }
POST /addPost
Creates a new WordPress post. Accepts JSON or multipart/form-data.
Request Headers:
Content-Type: application/json X-BLIPAISE-KEY: your-secret-api-key
JSON Body Parameters:
Field
Type
Required
Description
title
string
Yes
The post title. Sanitised with sanitize_text_field.
content
string
Yes
The post body. Full HTML is accepted and sanitised with wp_kses_post.
status
string
No
Post status. One of: publish, draft, pending, private. Defaults to publish.
featured_media
integer
No
The attachment ID of an existing media library item to use as the featured image.
image_data
string
No
A base64-encoded image to upload and set as the featured image. g. data:image/jpeg;base64,...
).
image_mime
string
No
The MIME type of the image_data image. Defaults to image/jpeg. Must be in your configured allowlist.
Example request (JSON with base64 image):
", "image_mime": "image/jpeg" }'
Example request (multipart file upload):
jpg"
Success Response (200 OK):
jpg" }
Error Responses:
HTTP Code
Error Code
Cause
400
blipaise_invalid_payload
Request body is empty or not valid JSON
400
blipaise_missing_fields
title or content is empty
400
blipaise_invalid_file_type
Uploaded file MIME type is not in the allowlist
400
blipaise_file_too_large
Uploaded file exceeds the configured size limit
400
blipaise_invalid_image_data
image_data is not valid base64 content
400
blipaise_upload_failed
WordPress file system error during upload
401
—
Missing or incorrect API key