Get Referrals Report V2

Get referral traffic report from the hourly aggregated materialized view (UTC-based).

Supports date_interval=“hour”, calendar intervals through “year”, “quarter”, and “relative_week”.

POST /v2/reports/referrals

JavaScript

JavaScript

import Profound from '@profoundai/client';

const client = new Profound({
  apiKey: process.env['PROFOUND_API_KEY'], // This is the default and can be omitted
});

const reportResponse = await client.reports.getReferralsReportV2({
  domain: 'domain',
  metrics: ['visits'],
  start_date: '2019-12-27T18:11:19.117Z',
});

console.log(reportResponse.data);

200

{
  "info": {
    "total_rows": 123,
    "query": {}
  },
  "data": [
    {
      "metrics": [
        123
      ],
      "dimensions": [
        "<string>"
      ]
    }
  ]
}

Authorizations

APIKeyHeaderBearerAuth

X-API-Key · string · header · required

Body

application/json

metrics · enum<string>[] · required

Available options: visits, last_visit

domain · string · required

Domain to query logs for.

start_date · string<date-time> · required

Start date for logs. Accepts: YYYY-MM-DD, YYYY-MM-DD HH:MM, YYYY-MM-DD HH:MM:SS, or full ISO timestamp.

date_interval · enum<string> · default: day

Date interval for the report. (only used with date dimension)

Available options: hour, day, week, month, quarter, year, relative_week

dimensions · enum<string>[]

Dimensions to group the report by.

Available options: date, hour, path, referral_source, referral_type

order_by · Order By · object

Custom ordering of the report results.

The order is a record of key-value pairs where:

• key is the field to order by, which can be a metric or dimension
• value is the direction of the order, either 'asc' for ascending or 'desc' for descending.

When not specified, the default order is the first metric in the query descending.

Show child attributes

Example:

{ "date": "asc" }

pagination · Pagination · object

Pagination settings for the report results.

Show child attributes

end_date · string<date-time>

End date in UTC. Accepts same formats as start_date. Defaults to now UTC if omitted.

organization_id · string<uuid> | null

timezone · string · default: UTC

IANA timezone name for date bucketing and filter boundaries.

metric_filters · NumericMetricFilter · object[]

Numeric filters applied after report metrics are calculated.

Show child attributes

filters · (PathFilter · object | ReferralSourceFilter · object | ReferralTypeFilter · object)[]

Filters for referrals report.

Filter by request path

PathFilter

ReferralSourceFilter

ReferralTypeFilter

Show child attributes

Response

200

application/json

Successful Response

Base response model for reports.

info · Info · object · required

Base model for report information.

Show child attributes

data · Result · object[] · required

Show child attributes