seline-logo
Public API
Overview
MCP

Funnel

Analyze a conversion funnel through multiple steps. Each step can be a page path (with optional wildcards) or a custom event. The endpoint returns the number of visitors who reached each step in order, plus the conversion-rate trend compared to the previous period.

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

Pathnames always start with a slash, e.g. /blog/*. Custom event step names must match the exact event name as you track it.

Parameters

steps
arrayRequired
Funnel steps in order. Must have at least 2 steps. Each step is an object with name (page pathname like /blog/* or custom event name) and type (page-view or custom).

Example - [{ name: "/", type: "page-view" }, { name: "user: signed up", type: "custom" }]
period
stringRequired if no range is provided
Predefined time period today, 1h, 24h, 7d, 30d, 6m, 12m, all_time, month_to_date, week_to_date, year_to_date. Either period or range is required.
range
objectRequired if no period is provided
Custom date range object with from and to ISO 8601 datetime strings, e.g. 2025-09-10T00:00:00Z, both required.

Example - { from: "2025-09-10T00:00:00Z", to: "2025-09-11T00:00:00Z" }
filters
array
Optional filters for the funnel. Array of objects with field and value. Supported fields are hostname, country, browser, device, referrer, campaign, source, medium, content, term, os.
Example request
curl -X POST 'https://api.seline.com/api/v1/funnel' \
  -H 'Authorization: Bearer API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "range": {
      "from": "2025-06-10T00:00:00Z",
      "to": "2025-09-10T00:00:00Z"
    },
    "steps": [
      { "name": "/", "type": "page-view" },
      { "name": "/pricing", "type": "page-view" },
      { "name": "user: signed up", "type": "custom" }
    ],
    "filters": [
      { "field": "country", "value": "US" }
    ]
  }'
Click anywhere to copy
Response
{
  "steps": [
    { "name": "/", "type": "page-view", "count": 1820 },
    { "name": "/pricing", "type": "page-view", "count": 612 },
    { "name": "user: signed up", "type": "custom", "count": 124 }
  ],
  "trend": 8
}
Click anywhere to copy