seline-logo
Public API
Overview
MCP

Visitors

Get a paginated list of visitors with comprehensive filtering options. Use this to find specific visitors, analyze visitor segments, or pull visitor profiles for various criteria.

POST
https://api.seline.com/api/v1/visitors
Click anywhere to copy

Parameters

projectId
stringRequired for account API keys
Project id to query. Required when using an account-wide API key. Ignored for project API keys.
filters
object
Optional filters using the visitor filtering schema. Supports pageview, event, country, browser, device, os, referrer, campaign, source, medium, content, term, firstSeen, lastActivity, users, tag, funnel and custom fields-*. Same operator syntax as filters elsewhere.
search
string
Search term to filter results. Case-insensitive.
skipCounts
boolean
Skip counting total visitors for a faster response. Default is false.
page
number
Page number for pagination
pageSize
number
Number of items per page. Default is 10. Maximum is 100.
Example request
curl -X POST 'https://api.seline.com/api/v1/visitors' \
  -H 'Authorization: Bearer API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "filters": {
      "country": "is:US",
      "event": "is:user: signed up"
    },
    "page": 1,
    "pageSize": 10
  }'
Click anywhere to copy
Response
{
  "visitors": [
    {
      "id": "a3f0...e1b8",
      "shortId": "kxw18m",
      "name": "Alex K.",
      "email": "alex@example.com",
      "country": "US",
      "device": "desktop"
    },
    ...
  ],
  "total": 124,
  "page": 1,
  "pageSize": 10,
  "hasMore": true
}
Click anywhere to copy