GET /v1/sources

GET /v1/sources — top sources/mediums with the FB social-vs-paid split.

Top sources (and optionally source × medium) for the project. This is the endpoint that surfaces the Facebook social-vs-paid split.

Auth

Required scope	read
Key kinds	rk_*

Request

GET /v1/sources?from=…&to=…&breakdown=source_medium
Authorization: Bearer rk_live_…

Query parameters

Name	Required	Notes
from	yes	ISO 8601 timestamp (inclusive).
to	yes	ISO 8601 timestamp (exclusive).
breakdown	no	source_medium (default) or source.
limit	no	1–200, default 50.

Response

{
  "breakdown": "source_medium",
  "rows": [
    { "source": "facebook", "medium": "paid",   "events": 6, "uniques": 6, "paid_share": 1.0 },
    { "source": "facebook", "medium": "social", "events": 3, "uniques": 3, "paid_share": 0.0 },
    { "source": "google",   "medium": "paid",   "events": 3, "uniques": 3, "paid_share": 1.0 },
    { "source": "direct",   "medium": "direct", "events": 7, "uniques": 7, "paid_share": 0.0 }
  ]
}

Each row:

• events — total events matching the breakdown.

• uniques — distinct anonymous_ids (HyperLogLog estimate).

• paid_share — count(medium='paid') / count(*) for the row. For breakdown=source_medium it's trivially 0 or 1; for breakdown=source it reveals what fraction of a source's traffic is paid (useful for "X% of our Facebook is paid").

Examples

"What's our Facebook social vs paid split this month?"

curl -G "https://api.millimetric.ai/v1/sources" \
  -H "Authorization: Bearer $RK_KEY" \
  --data-urlencode "from=2026-05-01T00:00:00Z" \
  --data-urlencode "to=2026-06-01T00:00:00Z"
# rows include separate facebook/paid and facebook/social entries

"Where does our traffic come from, ignoring paid/organic?"

curl -G "https://api.millimetric.ai/v1/sources" \
  -H "Authorization: Bearer $RK_KEY" \
  --data-urlencode "from=2026-05-01T00:00:00Z" \
  --data-urlencode "to=2026-06-01T00:00:00Z" \
  --data-urlencode "breakdown=source"
# rows include a paid_share column for each source

Related

• For more flexible aggregations, use /v1/stats with group_by=source,medium.

• For session-level entry source (better for revenue attribution), query sessions_v directly.