Skip to main content
GET
Get top sources
Returns the first 20 groups of one dimension. Set source_group to pick the dimension, for example channel_type, utm_campaign or device. Set source_metric to sessions or revenue to rank the groups by that value. Here, revenue comes from revenue events only. Payments from provider integrations show in the dashboard only.

Authorizations

Authorization
string
header
required

An API key (mana_api_...) with scopes. It reads reports and writes profile properties.

Path Parameters

projectId
string<uuid>
required

The project ID

Query Parameters

date_from
string

First day (UTC) as YYYY-MM-DD. Default: 29 days before date_to.

Pattern: ^\d{4}-\d{2}-\d{2}$
date_to
string

Last day (UTC) as YYYY-MM-DD. Default: today. The range is at most 367 days.

Pattern: ^\d{4}-\d{2}-\d{2}$
page_path
string

Only events on this page path

Maximum string length: 2048
Pattern: ^\/
utm_source
string
Maximum string length: 255
utm_medium
string
Maximum string length: 255
utm_campaign
string
Maximum string length: 255
utm_content
string
Maximum string length: 255
utm_term
string
Maximum string length: 255
ref
string

Referral code (ref link parameter)

Maximum string length: 255
paid_source
enum<string>

Ad network of a paid click

Available options:
google,
meta,
microsoft,
tiktok,
twitter,
linkedin,
reddit,
snapchat,
paid_utm
click_id
string

Ad click ID (gclid, fbclid and others)

Maximum string length: 255
channel_type
enum<string>

Acquisition channel

Available options:
Paid Search,
Paid Video,
Paid Social,
Paid Other,
Email,
Referrals,
Display,
AI,
Organic Search,
Organic Social,
Organic Video,
Referrers,
Direct
referrer
string

Referrer origin, for example https://www.reddit.com

Maximum string length: 2048
locale
string
Maximum string length: 32
device
enum<string>
Available options:
desktop,
mobile,
tablet,
bot
os
enum<string>
Available options:
windows,
macos,
ios,
android,
linux,
other
browser
enum<string>
Available options:
chrome,
safari,
firefox,
edge,
opera,
other
country
string

ISO 3166-1 alpha-2 country code

Pattern: ^[A-Za-z]{2}$
currency
string

Report currency for revenue (ISO 4217). Default: USD.

Pattern: ^[A-Z]{3}$
currency_mode
enum<string>

convert (default) converts other currencies with the rate of the event day. only counts the report currency alone.

Available options:
convert,
only
filters
string

Operator filters as a JSON array of { "field", "op", "value" }, combined with AND. At most 20.

Maximum string length: 8192
source_group
enum<string>

Default: source

Available options:
channel_type,
source,
referrer,
ref,
campaign,
paid_source,
utm_source,
utm_medium,
utm_campaign,
utm_content,
utm_term,
country,
device,
os,
browser
source_metric
enum<string>

What the rows count: visitors (default), sessions, or revenue from revenue events

Available options:
visitors,
sessions,
revenue

Response

The report

date_from
string
required

First day of the report

Pattern: ^\d{4}-\d{2}-\d{2}$
date_to
string
required

Last day of the report

Pattern: ^\d{4}-\d{2}-\d{2}$
rows
object[]
required
totals
object

Range totals (event-timeseries only). visitors is the unique count for the range; the other values are sums of all days.

notes
string[]

Fixed sentences on how to read the session columns, or why they are absent