Skip to main content

BlogToSocialResponse

blog_titlestring

The blog post title (scraped or provided directly).

Example: 10 Tips for Better Social Media
blog_excerptstring

A short excerpt from the blog post content.

Example: Social media success starts with consistency...
captions object[]

Generated captions, one per target account.

  • Array [
    • account_idinteger

    ID of the social account this caption was generated for.

    Example: 5
    providerstring

    Social media platform identifier.

    Example: x
    contentstringnullable

    The generated caption text. null if generation failed for this account.

    Example: Unlock better social media results with these 10 proven tips. #SocialMedia #Marketing
    character_countintegernullable

    Character count of the generated content. null if generation failed.

    Example: 87
    character_limitinteger

    Maximum allowed character count for this platform.

    Example: 280
    errorstringnullable

    Error message if caption generation failed for this account. null on success.

  • ]
    • post_uuidstring<uuid>nullable

    UUID of the created draft post. Only present when create_post was true.

    Example: 01942c3d-1234-7abc-8ef0-1234567890ab
    media objectnullable

    The imported featured image. Only present when create_post was true and an image was available.

    idinteger

    Media library ID of the imported image.

    Example: 42
    urlstring<uri>

    Public URL of the imported image in the workspace media library.

    Example: https://postboost.co/storage/workspaces/1/blog-images/2026/04/cover.jpg
    credits_usedinteger

    Number of AI credits consumed by this request (one per successful caption).

    Example: 3
    credits_remainingintegernullable

    Remaining AI credits for the current billing period. null for unlimited plans.

    Example: 37
    BlogToSocialResponse
    {
      "blog_title": "10 Tips for Better Social Media",
      "blog_excerpt": "Social media success starts with consistency...",
      "captions": [
        {
          "account_id": 5,
          "provider": "x",
          "content": "Unlock better social media results with these 10 proven tips. #SocialMedia #Marketing",
          "character_count": 87,
          "character_limit": 280,
          "error": "string"
        }
      ],
      "post_uuid": "01942c3d-1234-7abc-8ef0-1234567890ab",
      "media": {
        "id": 42,
        "url": "https://postboost.co/storage/workspaces/1/blog-images/2026/04/cover.jpg"
      },
      "credits_used": 3,
      "credits_remaining": 37
    }