seline-logo
Public API
Overview
MCP

Visitor insight

Generate AI-powered insights about a visitor's behavior based on their events. Pulls up to 1000 of the visitor's most recent events and returns a structured insight with main finding, details, bullet points, and recommendations.

POST
https://api.seline.com/api/v1/visitor-insight
Click anywhere to copy

This endpoint calls our AI provider and is significantly slower than other endpoints. Each call consumes one request from your monthly events limit.

Parameters

shortId
stringRequired
Visitor's shortId. It's the human-friendly id shown in the Dashboard URL (e.g. kxw18m).
context
string
Additional context or a specific question to guide the AI insight. If omitted, a default prompt is used.
Example request
curl -X POST 'https://api.seline.com/api/v1/visitor-insight' \
  -H 'Authorization: Bearer API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "shortId": "kxw18m",
    "context": "Why did this visitor not convert?"
  }'
Click anywhere to copy
Response
{
  "visitor": {
    "id": "a3f0...e1b8",
    "shortId": "kxw18m",
    "name": "Alex K.",
    "email": "[email protected]"
  },
  "eventsCount": 42,
  "insight": {
    "mainInsight": "Repeated visits to /pricing without signup",
    "details": "Alex visited /pricing 6 times across 3 sessions...",
    "bulletPoints": [
      "Multiple bounces from /docs after short reads",
      "Spent most time on /pricing"
    ],
    "recommendations": [
      "Trigger a contextual pricing FAQ on the 2nd pricing visit"
    ]
  }
}
Click anywhere to copy