Skip to main content
The bootstrap API runs a multi-phase initialization process for new projects. It analyzes your brand’s website, generates relevant AI search prompts, and collects initial data from AI providers. Bootstrap is asynchronous — each endpoint returns immediately and processing continues in the background.

​
Initialize

POST /api/v1/bootstrap/initialize

Start the project initialization process.
Request body:
FieldTypeRequiredDescription
project_idstring (UUID)YesThe project to initialize
brand_namestringYesYour brand name
urlstringYesYour brand’s website URL
countrystringNoTarget country for localized AI responses
languagestringNoTarget language
Response: 202 Accepted The server begins the initialization process in the background:
  1. Fetches and analyzes your website content
  2. Generates strategic topics and AI search prompts
  3. Auto-detects competitors from initial AI responses

​
Process prompts

POST /api/v1/bootstrap/prompt

Run prompt analysis across all AI providers.
Request body:
FieldTypeRequiredDescription
project_idstring (UUID)YesThe project to process
Response: 202 Accepted Prerequisite: Project must be in “initialized” state. The server sends all generated prompts to ChatGPT, Perplexity, and Google AI Overview, then analyzes responses for brand mentions, sentiment, position, and citations.

​
Complete

POST /api/v1/bootstrap/complete

Mark the bootstrap process as complete.
Request body:
FieldTypeRequiredDescription
project_idstring (UUID)YesThe project to complete
Response: 200 OK

​
Bootstrap states

The project’s bootstrap status progresses through these states: 
initializing → initialized → processing → analyzed → completed
If an error occurs, the status changes to error. You can retry from the failed phase. Poll GET /api/v2/projects/<project_id> to check the current bootstrap status.