Funnel API Reference

Docs
API
Funnels

Funnel

For instructions on how to authenticate to use this endpoint, see API overview.

Endpoints

POST /api/projects/:project_id/insights/funnel/

Create

Path Parameters

project_id
string

Query Parameters

format
string
One of: "csv""json"

Request Parameters

events
array
Events to filter on. One of events or actions is required.
actions
array
Actions to filter on. One of events or actions is required.
properties
Filter events by event property, person property, cohort, groups and more.
filter_test_accounts
boolean
Whether to filter out internal and test accounts. See "project settings" in your PostHog account for the filters.
date_from
string
Default: -7d
What date to filter the results from. Can either be a date 2021-01-01, or a relative date, like -7d for last seven days, -1m for last month, mStart for start of the month or yStart for the start of the year.
date_to
string
Default: -7d
What date to filter the results to. Can either be a date 2021-01-01, or a relative date, like -7d for last seven days, -1m for last month, mStart for start of the month or yStart for the start of the year.
breakdown
string
A property or cohort to break down on. You can select the type of the property with breakdown_type.
- event (default): a property key
- person: a person property key
- cohort: an array of cohort IDs (ie [9581,5812])
breakdown_type
string
Default: event
One of: "event""person""cohort""group""session"
Type of property to break down on.
funnel_window_interval
integer
Default: 14
Funnel window size. Set in combination with funnel_window_interval, so defaults to 'days'.
funnel_window_interval_type
string
Default: days
One of: "DAY""MINUTE""HOUR""WEEK""MONTH"
The type of interval. Used in combination with funnel_window_intervals.
funnel_viz_type
string
Default: steps
One of: "trends""time_to_convert""steps"
The visualisation type.
- steps Track instances progress between steps of the funnel
- trends Track how this funnel's conversion rate is trending over time.
- time_to_convert Track how long it takes for instances to convert
funnel_order_type
string
Default: ordered
One of: "strict""unordered""ordered"
- ordered - Step B must happen after Step A, but any number events can happen between A and B.
- strict - Step B must happen directly after Step A without any events in between.
- unordered - Steps can be completed in any sequence.
exclusions
array
Exclude users/groups that completed the specified event between two specific steps. Note that these users/groups will be completely excluded from the entire funnel.
aggregation_group_type_index
integer
0
Aggregate by users or by groups. 0 means user, >0 means a group. See interface for the corresponding ID of the group.
breakdown_limit
integer
Default: 10
funnel_window_days
integer
Default: 14
(DEPRECATED) Funnel window size in days. Use funnel_window_interval and funnel_window_interval_type

Response

Request

POST /api/projects/:project_id/insights/funnel

export POSTHOG_PERSONAL_API_KEY=[your personal api key]
curl 
    -H 'Content-Type: application/json'\
    -H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
    https://app.posthog.com/api/projects/:project_id/insights/funnel/\
	-d events=[{"id":"$pageview"}]

Response

RESPONSE

{
  "is_cached": true,
  "last_refresh": "2019-08-24T14:15:22Z",
  "timezone": "Africa/Abidjan",
  "result": [
    {
      "count": 0,
      "action_id": "string",
      "average_conversion_time": 0,
      "median_conversion_time": 0,
      "converted_people_url": "string",
      "dropped_people_url": "string",
      "order": "string"
    }
  ]
}

Funnel

Endpoints

Create

Path Parameters

Query Parameters

Request Parameters

Response

Request

Response

Questions?

Was this page useful?