Sign in

Get social content state

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

Returns everything stored for the app's social content flow: how far it has got, the questions and your answers, the current strategy, and the content plan.

Read stage to see where the app is. An app that never started the flow returns stage of idle and null for everything else, rather than a 404.

Poll this endpoint after Generate content plan returns. Only the first platform's images are generated inline, so the rest of the image_url values appear here as they finish. A stage of generating means a plan is still being built, and the endpoints that change the plan fail with a 409 until it finishes.

This endpoint is limited to 40 requests per minute, separately from the other social content endpoints.

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

get/api/apps/{app_id}/virality/state

Path parameters

app_idstring required

ID of the app.

ID of the app.

Response

The app's social content state.

stage'idle' | 'questions' | 'strategy' | 'generating' | 'completed'
analysis_textstring nullable

One-sentence analysis of the app, or null if the flow hasn't started.

answersobject nullable

Answers you submitted, keyed by question id, or null if none were submitted.

strategy_textstring nullable

The current content strategy, or null if none was generated.

builder_handlestring nullable

Social handle taken from the social_url you submitted, or null if you never sent one.

app_namestring nullable

Name of the app.

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.",
  "answers": {
    "goal": "Get the first 100 users"
  },
  "strategy_text": "Lead with the spreadsheet pain, then show the app solving it.",
  "plan": {
    "id": "8c1f9a2e-3b7d-4c5e-9f01-2a3b4c5d6e7f",
    "app_id": "6820f3a4e7b91d003c45a1f2",
    "strategy": {
      "app_summary": "A CRM for freelancers who want to track leads without a spreadsheet.",
      "marketing_approach": "Lead with the spreadsheet pain, then show the app solving it.",
      "platforms": [
        {
          "reasoning": "Instagram rewards a consistent series, so these build on each other.",
          "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"
            }
          ]
        }
      ]
    },
    "created_at": "2026-08-24T09:15:00+00:00",
    "updated_at": "2026-08-24T10:02:00+00:00"
  },
  "builder_handle": "@yourhandle",
  "app_name": "Freelance CRM",
  "teaser": {
    "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