Back to API overview
Content
RoadmapAI-generated blog posts, video scripts, social posts, and review responses. Includes draft, publish, and revision workflows. Activates during pilot phase.
GET
/api/v1/contentreadRoadmapList content items
Filter by type (blog | video | social | review_response), status (draft | scheduled | published), channel.
Example response
{
"data": [
{
"id": "ctnt_3p9w7m2q4r",
"type": "blog",
"title": "Water Damage Restoration in Alpharetta, What to Do in the First 24 Hours",
"status": "published",
"channel": "wordpress",
"url": "https://example.com/blog/water-damage-alpharetta-first-24-hours",
"word_count": 1842,
"target_keyword": "water damage alpharetta",
"published_at": "2026-04-22T15:00:00.000Z"
}
],
"next_cursor": null
}POST
/api/v1/content/blogwriteRoadmapGenerate a blog post
Generate an SEO-optimized blog draft for a target keyword and service area.
Example request body
{
"target_keyword": "mold removal roswell",
"service_area": { "city": "Roswell", "region": "GA", "postal_code": "30075" },
"service_type": "mold_remediation",
"word_count_target": 2000
}Example response
{
"id": "ctnt_7k1m4n9z",
"type": "blog",
"status": "draft",
"title": "Mold Removal in Roswell, GA, What Homeowners Need to Know",
"estimated_read_time_min": 9,
"word_count": 2014,
"created_at": "2026-04-27T19:14:08.118Z"
}POST
/api/v1/content/video-scriptwriteRoadmapGenerate a video script
Returns a HeyGen-ready script in scenes with B-roll suggestions, lower-third copy, and a 30s cutdown variant.
Example request body
{
"topic": "5 signs of hidden water damage in your basement",
"format": "feature",
"duration_seconds": 180
}Example response
{
"id": "ctnt_v8r3p2q9",
"type": "video",
"status": "draft",
"scenes": [
{ "scene": 1, "voiceover": "Hidden water damage starts where you can't see it...", "broll_suggestion": "basement wall close-up" }
],
"cutdown_30s_id": "ctnt_v8r3p2q9_30s"
}POST
/api/v1/content/review-responsewriteRoadmapGenerate a customer-review response
Generates a brand-aligned response. Sentiment is auto-classified; negative reviews route to the franchise owner before any public response.
Example request body
{
"platform": "google",
"review_id": "g_review_z2x8c4v1",
"rating": 5,
"review_text": "PuroClean was at our house within 45 minutes after a pipe burst...",
"tone": "warm-professional"
}Example response
{
"response_text": "Thank you, Sarah! We're glad we could be there fast and get the home dried out, the team appreciates the kind words.",
"sentiment": "positive",
"auto_publish_recommended": true
}POST
/api/v1/content/{id}/publishwriteRoadmapPublish to configured destinations
Publish to WordPress, social, GBP, or review platform. Returns per-channel status.
Example request body
{
"channels": ["wordpress", "instagram", "facebook"],
"scheduled_for": null
}Example response
{
"id": "ctnt_3p9w7m2q4r",
"results": [
{ "channel": "wordpress", "status": "published", "url": "https://example.com/blog/..." },
{ "channel": "instagram", "status": "queued", "estimated_publish_at": "2026-04-27T20:00:00.000Z" }
]
}