Sign in

Start social content flow

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

Starts the social content flow for an app. Base44 reads the app, returns a one-sentence analysis of it, and asks 2 or 3 questions whose answers shape the content strategy.

Answer them with Submit answers. Calling this endpoint again restarts the flow: it discards any answers, strategy, and content plan already stored for the app. It fails with a 409 while a content plan is generating, so reset or finish that first.

This endpoint calls a language model, so expect it to take a few seconds. It shares a limit of 15 requests per minute with the other social content endpoints, except Get social content state and Generate a post image, which have their own.

<Note>The questions are generated per app, so both their number and their wording vary between calls. Read id and type off each question rather than assuming a fixed set.</Note>

<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 may include fields beyond the ones documented here. Don't use any undocumented fields, as they can change at any time.</Warning>

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

Path parameters

app_idstring required

ID of the app.

ID of the app.

Response

The app analysis and the questions to answer next.

analysis_textstring nullable

One-sentence analysis of the app, to show above the questions.

Example response

{
  "questions": [
    {
      "id": "goal",
      "question": "What does success look like for this app?",
      "type": "select",
      "options": [
        {
          "label": "Get the first 100 users",
          "description": "Focus on early adopters who give feedback"
        }
      ],
      "placeholder": "https://x.com/yourhandle"
    }
  ],
  "analysis_text": "A CRM for freelancers who want to track leads without a spreadsheet."
}

Changes