Sign in

Generate teaser posts

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Generates two social posts for an app, one for Instagram and one for LinkedIn, each with an image. They're written from the app alone, with no questions to answer first, and they're separate from the content plan.

The posts are generated once per app. Calling this again returns the existing posts rather than new ones, and a call while they're generating starts nothing. A failed generation can run again a day after it failed, and one that stops without finishing can run again after 4 minutes. Base44 can also regenerate the posts once after a change to their format.

The call returns as soon as generation starts, with a status of generating. Poll Get social content state and read teaser until its status is ready or failed. Generation takes up to 3 minutes. When Base44 has teaser generation turned off, the call returns a status of null and no posts.

This endpoint calls a language model and an image model, but it's free. It doesn't use any credits.

This is limited to 5 requests a minute per app for each workspace's personal API keys, so every key in a workspace shares one allowance, separately from the other social content endpoints. Some workspaces have a different limit.

<Note>This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.</Note>

<Warning>The response includes fields beyond the ones documented here. Don't rely on undocumented response fields, as they can change at any time.</Warning>

post/api/apps/{app_id}/virality/teaser

Path parameters

app_idstring required

ID of the app.

ID of the app.

Response

Successful Response

status'generating' | 'ready' | 'failed'

Example response

{
  "post": {
    "id": "3f2504e0-4f89-11d3-9a0c-0305e82c3301",
    "angle_label": "Pain point",
    "post_number": 1,
    "total_posts": 5,
    "suggested_day": 1,
    "rationale": "Opens on the spreadsheet frustration the audience already has.",
    "content": "Still tracking leads in a spreadsheet? I built the thing I wanted instead.",
    "image_url": "https://storage.base44.com/virality/3f2504e0.png",
    "image_prompt": "A freelancer closing a laptop at a tidy desk, warm morning light",
    "hashtags": [
      "freelance",
      "buildinpublic"
    ],
    "post_title": "I built a CRM because spreadsheets kept losing my leads",
    "suggested_subreddits": [
      "r/freelance",
      "r/SideProject"
    ],
    "launch_comment": "Happy to answer questions about how it works.",
    "option_label": "Direct and personal",
    "best_for_context": "Best if your audience already knows you"
  },
  "posts": [
    {
      "id": "3f2504e0-4f89-11d3-9a0c-0305e82c3301",
      "angle_label": "Pain point",
      "post_number": 1,
      "total_posts": 5,
      "suggested_day": 1,
      "rationale": "Opens on the spreadsheet frustration the audience already has.",
      "content": "Still tracking leads in a spreadsheet? I built the thing I wanted instead.",
      "image_url": "https://storage.base44.com/virality/3f2504e0.png",
      "image_prompt": "A freelancer closing a laptop at a tidy desk, warm morning light",
      "hashtags": [
        "freelance",
        "buildinpublic"
      ],
      "post_title": "I built a CRM because spreadsheets kept losing my leads",
      "suggested_subreddits": [
        "r/freelance",
        "r/SideProject"
      ],
      "launch_comment": "Happy to answer questions about how it works.",
      "option_label": "Direct and personal",
      "best_for_context": "Best if your audience already knows you"
    }
  ]
}

Changes

Changed in 1 of the 22 revisions of this API.1

Of the 22 revisions, 1 has no diff computed.