Start social content flow

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/virality/start \
  --header 'api_key: <api-key>'

const options = {method: 'POST', headers: {api_key: '<api-key>'}};

fetch('https://app.base44.com/api/apps/{app_id}/virality/start', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/apps/{app_id}/virality/start",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "api_key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/virality/start"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("api_key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/virality/start")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "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."
}

Virality

Start social content flow

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

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.

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.

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

The response includes fields beyond the ones documented here. Don’t rely on undocumented response fields, as they can change at any time.

POST

api

apps

{app_id}

virality

start

Start social content flow

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/virality/start \
  --header 'api_key: <api-key>'

const options = {method: 'POST', headers: {api_key: '<api-key>'}};

fetch('https://app.base44.com/api/apps/{app_id}/virality/start', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/apps/{app_id}/virality/start",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "api_key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/virality/start"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("api_key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/virality/start")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "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."
}

Authorizations

api_key

string

header

required

Personal API key.

Path Parameters

app_id

string

required

ID of the app.

Response

Successful Response

The opening analysis of an app and the questions it raised.

questions

ViralityQuestion · object[]

Questions to answer before a strategy is generated. Usually 2 or 3, with a social profile question last.

Show child attributes

analysis_text

string | null

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

Example:

"A CRM for freelancers who want to track leads without a spreadsheet."

Base44 APIs

Apps API (Beta)

Monitoring API

Audit Logs API

Start social content flow

Authorizations

Path Parameters

Response