Use case
Write SEO blog posts
Works on: WordPress (WordPress.com or self-hosted, on your own domain)
Connect your WordPress site and let your agent turn what already works on your socials into articles that rank on your own domain. Drafts by default, so you review before anything goes live.
- 1
Connect a self-hosted site with an Application Password (WordPress.com: GET /v1/connect/wordpress and send the user to auth_url).
curl -X POST "https://creatoros-production-5658.up.railway.app/v1/connect/wordpress" \ -H "Authorization: Bearer $CREATOROS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "site_url": "https://yoursite.com", "username": "kevin", "application_password": "abcd efgh ijkl mnop qrst uvwx" }' - 2
See what’s already published, so new posts cover new ground and can link to old ones.
curl "https://creatoros-production-5658.up.railway.app/v1/blog/articles" \ -H "Authorization: Bearer $CREATOROS_API_KEY" - 3
Write the article as a draft: one keyword in the title, first paragraph, a heading and the slug, plus an excerpt for the description.
curl -X POST "https://creatoros-production-5658.up.railway.app/v1/blog/articles" \ -H "Authorization: Bearer $CREATOROS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "title": "Best time to post on TikTok in 2026", "bodyHtml": "<p>We looked at 12,000 posts...</p><h2>The short answer</h2><p>...</p>", "handle": "best-time-to-post-on-tiktok", "excerpt": "When to post on TikTok for the most views in 2026, by day and hour, from 12,000 real posts.", "tags": [ "tiktok", "posting schedule" ], "image": { "url": "https://example.com/cover.jpg", "altText": "TikTok posting heatmap" }, "isPublished": false }' - 4
Publish it once it’s approved.
curl -X PATCH "https://creatoros-production-5658.up.railway.app/v1/blog/articles/1842" \ -H "Authorization: Bearer $CREATOROS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "isPublished": true }'
Articles are HTML (bodyHtml), not Markdown. SEO plugin fields (Yoast, Rank Math) aren't set through the API; the excerpt is what most themes use as the page description.
With the CLI
$ creatoros blog:connect-selfhosted --site https://yoursite.com --username kevin --password "abcd efgh ijkl mnop qrst uvwx"Copy$ creatoros blog:list --prettyCopy$ creatoros blog:create --title "Best time to post on TikTok in 2026" --file post.html --slug best-time-to-post-on-tiktok --tags tiktok,schedulingCopy$ creatoros blog:update <articleId> --publishCopyOr ask your agent
“Look at my three best-performing posts this month and turn the strongest one into a 1,200-word SEO article for my blog. Save it as a draft.”