For AI agents: A markdown version of this page is available at https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/api/latest/rum-audience-management/query-event-filtered-users.md. A documentation index is available at /llms.txt.
Language
Datadog site

Query event filtered users

WARNINGNote: This endpoint may be subject to changes.
POSThttps://api.datadoghq.com/api/v2/product-analytics/users/event_filtered_queryhttps://api.us3.datadoghq.com/api/v2/product-analytics/users/event_filtered_queryhttps://api.us5.datadoghq.com/api/v2/product-analytics/users/event_filtered_queryhttps://api.datadoghq.eu/api/v2/product-analytics/users/event_filtered_queryhttps://api.ap1.datadoghq.com/api/v2/product-analytics/users/event_filtered_queryhttps://api.ap2.datadoghq.com/api/v2/product-analytics/users/event_filtered_queryhttps://api.uk1.datadoghq.com/api/v2/product-analytics/users/event_filtered_queryhttps://api.ddog-gov.com/api/v2/product-analytics/users/event_filtered_queryhttps://api.us2.ddog-gov.com/api/v2/product-analytics/users/event_filtered_query

Overview

Query users filtered by both user properties and event platform data

Request

Body Data (required)

Field
Type
Description
data
object

The data object containing the resource type and attributes for querying event-filtered users.

Response

Successful response with filtered user data

Response containing the query results with matched records and total count.

Field
Type
Description
data
object

The data object containing the resource type and attributes of the query response.

Code Example

# Set your Datadog site and credentials
export DD_SITE="datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/product-analytics/users/event_filtered_query" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "event_query": {
        "query": "@type:view AND @view.loading_time:>3000 AND @application.name:ecommerce-platform",
        "time_frame": {
          "end": 1761309676,
          "start": 1760100076
        }
      },
      "include_row_count": true,
      "limit": 25,
      "query": "user_org_id:5001 AND first_country_code:US AND first_browser_name:Chrome",
      "select_columns": [
        "user_id",
        "user_email",
        "first_country_code",
        "first_browser_name",
        "events_count",
        "session_count",
        "error_count",
        "avg_loading_time"
      ]
    },
    "id": "query_event_filtered_users_request",
    "type": "query_event_filtered_users_request"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="us3.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/product-analytics/users/event_filtered_query" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "event_query": {
        "query": "@type:view AND @view.loading_time:>3000 AND @application.name:ecommerce-platform",
        "time_frame": {
          "end": 1761309676,
          "start": 1760100076
        }
      },
      "include_row_count": true,
      "limit": 25,
      "query": "user_org_id:5001 AND first_country_code:US AND first_browser_name:Chrome",
      "select_columns": [
        "user_id",
        "user_email",
        "first_country_code",
        "first_browser_name",
        "events_count",
        "session_count",
        "error_count",
        "avg_loading_time"
      ]
    },
    "id": "query_event_filtered_users_request",
    "type": "query_event_filtered_users_request"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="us5.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/product-analytics/users/event_filtered_query" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "event_query": {
        "query": "@type:view AND @view.loading_time:>3000 AND @application.name:ecommerce-platform",
        "time_frame": {
          "end": 1761309676,
          "start": 1760100076
        }
      },
      "include_row_count": true,
      "limit": 25,
      "query": "user_org_id:5001 AND first_country_code:US AND first_browser_name:Chrome",
      "select_columns": [
        "user_id",
        "user_email",
        "first_country_code",
        "first_browser_name",
        "events_count",
        "session_count",
        "error_count",
        "avg_loading_time"
      ]
    },
    "id": "query_event_filtered_users_request",
    "type": "query_event_filtered_users_request"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="datadoghq.eu"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/product-analytics/users/event_filtered_query" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "event_query": {
        "query": "@type:view AND @view.loading_time:>3000 AND @application.name:ecommerce-platform",
        "time_frame": {
          "end": 1761309676,
          "start": 1760100076
        }
      },
      "include_row_count": true,
      "limit": 25,
      "query": "user_org_id:5001 AND first_country_code:US AND first_browser_name:Chrome",
      "select_columns": [
        "user_id",
        "user_email",
        "first_country_code",
        "first_browser_name",
        "events_count",
        "session_count",
        "error_count",
        "avg_loading_time"
      ]
    },
    "id": "query_event_filtered_users_request",
    "type": "query_event_filtered_users_request"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="ap1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/product-analytics/users/event_filtered_query" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "event_query": {
        "query": "@type:view AND @view.loading_time:>3000 AND @application.name:ecommerce-platform",
        "time_frame": {
          "end": 1761309676,
          "start": 1760100076
        }
      },
      "include_row_count": true,
      "limit": 25,
      "query": "user_org_id:5001 AND first_country_code:US AND first_browser_name:Chrome",
      "select_columns": [
        "user_id",
        "user_email",
        "first_country_code",
        "first_browser_name",
        "events_count",
        "session_count",
        "error_count",
        "avg_loading_time"
      ]
    },
    "id": "query_event_filtered_users_request",
    "type": "query_event_filtered_users_request"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="ap2.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/product-analytics/users/event_filtered_query" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "event_query": {
        "query": "@type:view AND @view.loading_time:>3000 AND @application.name:ecommerce-platform",
        "time_frame": {
          "end": 1761309676,
          "start": 1760100076
        }
      },
      "include_row_count": true,
      "limit": 25,
      "query": "user_org_id:5001 AND first_country_code:US AND first_browser_name:Chrome",
      "select_columns": [
        "user_id",
        "user_email",
        "first_country_code",
        "first_browser_name",
        "events_count",
        "session_count",
        "error_count",
        "avg_loading_time"
      ]
    },
    "id": "query_event_filtered_users_request",
    "type": "query_event_filtered_users_request"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="uk1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/product-analytics/users/event_filtered_query" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "event_query": {
        "query": "@type:view AND @view.loading_time:>3000 AND @application.name:ecommerce-platform",
        "time_frame": {
          "end": 1761309676,
          "start": 1760100076
        }
      },
      "include_row_count": true,
      "limit": 25,
      "query": "user_org_id:5001 AND first_country_code:US AND first_browser_name:Chrome",
      "select_columns": [
        "user_id",
        "user_email",
        "first_country_code",
        "first_browser_name",
        "events_count",
        "session_count",
        "error_count",
        "avg_loading_time"
      ]
    },
    "id": "query_event_filtered_users_request",
    "type": "query_event_filtered_users_request"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/product-analytics/users/event_filtered_query" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "event_query": {
        "query": "@type:view AND @view.loading_time:>3000 AND @application.name:ecommerce-platform",
        "time_frame": {
          "end": 1761309676,
          "start": 1760100076
        }
      },
      "include_row_count": true,
      "limit": 25,
      "query": "user_org_id:5001 AND first_country_code:US AND first_browser_name:Chrome",
      "select_columns": [
        "user_id",
        "user_email",
        "first_country_code",
        "first_browser_name",
        "events_count",
        "session_count",
        "error_count",
        "avg_loading_time"
      ]
    },
    "id": "query_event_filtered_users_request",
    "type": "query_event_filtered_users_request"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="us2.ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/product-analytics/users/event_filtered_query" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "event_query": {
        "query": "@type:view AND @view.loading_time:>3000 AND @application.name:ecommerce-platform",
        "time_frame": {
          "end": 1761309676,
          "start": 1760100076
        }
      },
      "include_row_count": true,
      "limit": 25,
      "query": "user_org_id:5001 AND first_country_code:US AND first_browser_name:Chrome",
      "select_columns": [
        "user_id",
        "user_email",
        "first_country_code",
        "first_browser_name",
        "events_count",
        "session_count",
        "error_count",
        "avg_loading_time"
      ]
    },
    "id": "query_event_filtered_users_request",
    "type": "query_event_filtered_users_request"
  }
}
EOF