Getting started

IntentOS Documentation

IntentOS is a social media competitor intelligence platform. This documentation covers the internal API, data models, and integration details for Pro and Enterprise users.

Authentication

All API requests require a Bearer token obtained through Supabase authentication. Include it in the Authorization header of every request.

curl -X POST https://app.intentos.eu/api/pipeline/run \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"configId": "...", "maxVideos": 10, "topK": 5, "nDays": 30, "userId": "..."}'

Obtain your access token by signing in through the dashboard and inspecting the session token, or via the Supabase client SDK using supabase.auth.getSession().

Endpoints

{
  "configId": "uuid",
  "maxVideos": 20,
  "topK": 5,
  "nDays": 30,
  "userId": "uuid"
}

// SSE stream — each event is a PipelineProgress object
data: {
  "status": "running",
  "phase": "scraping",
  "creatorsCompleted": 1,
  "creatorsTotal": 4,
  "videosAnalyzed": 0,
  "videosTotal": 0,
  "errors": [],
  "log": ["Scraping @garyvee..."]
}

Data Models

Rate Limits