Workflows & Guides

Step-by-step guides for common API workflows. Follow these patterns to go from topic discovery to published content across all your channels.

Search to Publish

The primary workflow: discover a trending article, generate branded content from it, enrich the article, create a video, and publish everywhere. Total cost: 350 credits.

1

Search for articles

10 credits

Find trending articles relevant to your industry or a specific topic.

POST /api/v1/agents/news-aggregator
{
  "topic": "AI startups funding 2026",
  "searchConfig": {
    "resultLimit": 5
  }
}
2

Generate content from a URL

100 credits

Pick an article from the search results and generate branded content from it.

POST /api/v1/pipelines
{
  "pipelineType": "content-analyzer",
  "url": "https://example.com/ai-startup-funding"
}
3

Poll until complete

Free

Content generation runs asynchronously. Poll the status endpoint until the run completes (typically 1-3 minutes).

GET /api/v1/pipelines/{runId}

// Response when complete:
{
  "status": "completed",
  "results": {
    "data": {
      "agents": {
        "aiContentGenerator": {
          "generatedContent": {
            "linkedInPosts": [{ "intro": "...", "mainContent": "...", "callToAction": "..." }],
            "instagramPosts": [{ "caption": "...", "hashtags": ["#..."] }],
            "articles": [{ "title": "...", "introduction": "...", "sections": [{ "heading": "...", "content": "..." }] }]
          }
        },
        "scriptGenerator": { "scripts": [{ "hook": "...", "mainContent": [...], "callToAction": "..." }] },
        "imageFinder": { "foundImages": [{ "imageUrl": "https://...", "altText": "...", "suggestedUse": "hero" }] },
        "carouselGenerator": { "carousel": { "slides": [{ "slideNumber": 1, "text": "..." }] } }
      }
    }
  }
}
4

Enrich the article with images and links

40 credits

Add matched images and internal links to the generated article for a polished, publication-ready result.

POST /api/v1/enrich/images
{
  "article": {
    "title": "Article title",
    "sections": [{ "heading": "Section heading", "content": "Section body..." }]
  },
  "images": [
    { "imageUrl": "https://...", "altText": "Description", "suggestedUse": "hero" }
  ]
}

POST /api/v1/enrich/internal-links
{
  "article": {
    "title": "Article title",
    "introduction": "Intro text...",
    "sections": [{ "heading": "Section heading", "content": "Section body..." }]
  },
  "businessProfile": {
    "sitemapUrl": "https://example.com/sitemap.xml",
    "websiteUrl": "https://example.com"
  }
}
5

Create a video reel from pipeline results

200 credits

Extract scripts, carousel slides, and images from the completed pipeline results to build a video. Map carousel slide text to video slides and pair with hero images.

// From completed pipeline results, extract:
// hook = results.data.agents.scriptGenerator.scripts[0].hook
// script = join scripts[0].mainContent[].voiceOver
// slides = carouselGenerator.carousel.slides + imageFinder.foundImages

POST /api/v1/videos
{
  "script": "Here is what happened... The impact is huge...",
  "hook": "Breaking news you need to know!",
  "slides": [
    { "text": "Key takeaway slide 1", "imageUrl": "https://cdn.example.com/img1.jpg",
      "highlight": "Key takeaway", "imageMode": "background_with_overlays" },
    { "text": "Supporting point", "imageUrl": "https://cdn.example.com/img2.jpg",
      "highlight": "Supporting", "imageMode": "background_with_overlays" }
  ],
  "style": { "accentColor": "#75F30F", "captionStyle": "outlined", "captionPosition": "center" }
}

// Poll: GET /api/v1/videos/{jobId} every 5s
// Max 2 concurrent renders
6

Post to social media

Free

Publish the generated content to your connected social media accounts.

POST /api/v1/social/post
{
  "contentId": "uuid-of-saved-content",
  "platforms": [
    {
      "accountId": "uuid-of-connected-account",
      "platform": "linkedin",
      "contentType": "text",
      "caption": "Post caption..."
    }
  ]
}
7

Publish to your CMS

Free

Push the enriched article to your WordPress, Shopify, Ghost, or Notion site.

POST /api/v1/cms/publish
{
  "contentId": "uuid-of-saved-content",
  "cmsAccountId": "uuid-of-connected-cms",
  "title": "Article Title",
  "content": "<p>HTML content...</p>",
  "status": "draft"
}

Connect Your AI Agent

GenerateBot works with popular AI agents and CLI tools. Connect your preferred tool to automate content creation end-to-end.

OpenClaw

Configure OpenClaw to call GenerateBot endpoints using your API key. Define tools that map to the search, generate, and publish endpoints for a fully automated content workflow.

Claude Code

Set up Claude Code with your GenerateBot API key as an environment variable. Use it to build custom scripts that search for news, generate content, and schedule posts programmatically.

Codex CLI

Integrate the GenerateBot API into your Codex CLI workflows. Automate content creation as part of your development pipeline with simple HTTP requests.

Note: Full setup instructions with pre-configured files are available in your dashboard under Settings > API Keys. Each integration includes ready-to-use configuration that you can download and start using immediately.

Credit Costs

Every API operation that involves AI processing costs credits. Read operations and publishing actions are free.

OperationCredits
Search (News Aggregator)10
Content Generation (Pipeline)100
Video Creation200
Enrich - Internal Links20
Enrich - Images20
Script Generator15
Reddit Replier10
Business Profile Generator5
Brand Voice Rewriter5
AI Image Generator10
Content Library (CRUD)Free
Social Media (Post/History)Free
CMS PublishingFree
Credits (Balance/Transactions)Free
View Full API ReferenceBack to Overview