seline-logo
Public API
Overview
MCP

Field values

Get possible values for a specific custom event field with pagination and search. For example, all the values for a search-text field on a site: searched custom event. You can use the field keys endpoint first to discover available fields.

POST
https://api.seline.com/api/v1/field-values
Click anywhere to copy

Parameters

event
stringRequired
Custom event name to analyze. The exact name as it appears in your events list.
field
stringRequired
Custom event field (data key) to get values for. You can use the field keys endpoint first to discover available fields for an event.
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" }
search
string
Search term to filter results. Case-insensitive.
page
number
Page number for pagination
Example request
curl -X POST 'https://api.seline.com/api/v1/field-values' \
  -H 'Authorization: Bearer API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "event": "site: searched",
    "field": "search-text",
    "range": {
      "from": "2025-06-10T00:00:00Z",
      "to": "2025-09-10T00:00:00Z"
    },
    "page": 1
  }'
Click anywhere to copy
Response
{
  "items": [
    { "value": "analytics", "count": 188 },
    { "value": "pricing", "count": 76 },
    { "value": "stripe integration", "count": 42 }
  ],
  "hasMore": false
}
Click anywhere to copy