Filters, Periods, and Pagination
Use Faurya CLI periods, date ranges, filters, limits, cursors, metrics, dimensions, and pagination controls.
Filters, Periods, and Pagination
Many analytics commands accept shared query controls. Command-specific help shows whether a command supports filters.
faurya analytics overview --helpPeriod shortcuts
Use --period with a shortcut period.
| Value | Meaning |
|---|---|
today | From the start of the current day to now. |
yesterday | The previous calendar day. |
last24h | The last 24 hours. |
lastNd | The last N days, such as last7d, last30d, or last90d. |
faurya analytics overview <websiteId> --period last30dfaurya analytics timeseries <websiteId> --period last7d --granularity dayExplicit date ranges
Use --from and --to for an explicit ISO datetime range. You can also provide --timezone.
faurya analytics overview <websiteId> --from 2026-07-01T00:00:00.000Z --to 2026-07-19T00:00:00.000Zfaurya analytics goals <websiteId> --from 2026-07-01T00:00:00.000Z --to 2026-07-19T00:00:00.000Z --timezone UTCGranularity
Supported --granularity values are hour, day, week, month, quarter, and year.
faurya analytics revenue <websiteId> --period last90d --granularity weekRepeatable filters
Use -F or --filter. You can repeat the flag to combine multiple filters.
faurya analytics visitors list <websiteId> --period last30d -F country=US -F device=desktopfaurya analytics events list <websiteId> --period last30d --filter event=signupFilter syntax
The CLI accepts these forms:
| Syntax | Meaning |
|---|---|
field=value | Equality filter. |
field:operator=value | Filter with an explicit operator. |
field:in=a,b,c | in filter with comma-separated values. |
faurya analytics overview <websiteId> --period last30d -F country=USfaurya analytics revenue <websiteId> --period last30d -F revenue:gt=0faurya analytics events list <websiteId> --period last30d -F event:in=signup,purchaseSupported filter fields
Short field names:
| Field | Canonical focus |
|---|---|
country | Event country. |
region | Event region. |
city | Event city. |
path | Event page path. |
hostname | Event hostname. |
browser | Event browser. |
os | Event operating system. |
device | Event device. |
referrer | Event referrer. |
source | Acquisition source. |
medium | Acquisition medium. |
campaign | Acquisition campaign. |
revenue | Event or payment amount. |
event | Event name. |
goal | Goal event name. |
Canonical field names are also accepted: event.country, event.region, event.city, event.path, event.hostname, event.browser, event.os, event.device, event.referrer, event.properties.source, event.properties.medium, event.properties.campaign, event.amount, and event.name.
Supported operators
| Operator | Meaning |
|---|---|
eq, equals | Equal to. |
not, is_not, not_equals | Not equal to. |
contains | Contains a substring. |
in | One of multiple values. |
gt, greater_than | Greater than. |
gte, greater_than_or_equal | Greater than or equal to. |
lt, less_than | Less than. |
lte, less_than_or_equal | Less than or equal to. |
in behavior
For command-line filters, in values are comma-separated. Do not include spaces unless the value itself requires quoting in your shell.
faurya analytics visitors list <websiteId> --period last30d -F country:in=US,CA,GBNumeric revenue filters
Use numeric operators with revenue when filtering event or payment amount.
faurya analytics payments <websiteId> --period last30d -F revenue:gt=0faurya analytics revenue <websiteId> --period last30d -F revenue:lte=1000000Combining filters
Multiple -F or --filter flags are combined in the request.
faurya analytics overview <websiteId> --period last30d -F country=US -F browser=Chrome -F revenue:gt=0For advanced nested filter objects, use Structured Input.
Limits and cursors
The CLI validates --limit as a positive integer up to 5000. Some commands apply a smaller command-specific maximum.
faurya analytics events list <websiteId> --period last30d --limit 100Use --cursor to continue pagination explicitly.
faurya analytics events list <websiteId> --period last30d --limit 100 --cursor <cursor>Pagination is not automatic. Continue each page yourself with the cursor returned by the previous command.
Metrics and dimensions
Use comma-separated values for --metrics and --dimensions.
faurya analytics overview <websiteId> --period last30d --metrics visitors,sessions,pageviewsfaurya analytics breakdown <websiteId> country --period last30d --metrics visitors,sessionsAnalytics
Use Faurya CLI analytics commands for overview, realtime, timeseries, breakdowns, visitors, sessions, events, journeys, goals, paths, cohorts, payments, revenue, attribution, AI crawls, and changes.
Structured Input
Use --input and --input-file for Faurya CLI commands that require structured JSON fields.