ContactAbout
Expert AI Labs
Back to API overview

Content

Roadmap

AI-generated blog posts, video scripts, social posts, and review responses. Includes draft, publish, and revision workflows. Activates during pilot phase.

GET/api/v1/contentreadRoadmap

List 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/blogwriteRoadmap

Generate 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-scriptwriteRoadmap

Generate 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-responsewriteRoadmap

Generate 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}/publishwriteRoadmap

Publish 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" }
  ]
}
ProspectsOutreach