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

Consultar usuarios

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

Descripción general

Consultar usuarios con filtrado flexible por propiedades de usuario, con búsqueda por comodín opcional

Solicitud

Body Data (required)

Campo
Type
Descripción
data
object

Respuesta

Successful response with user data

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

Campo
Type
Descripción
data
object

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

Ejemplo de código

Consultar usuarios
# 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/query" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "limit": 25,
      "query": "user_email:*@techcorp.com AND first_country_code:US AND first_browser_name:Chrome",
      "select_columns": [
        "user_id",
        "user_email",
        "user_name",
        "user_org_id",
        "first_country_code",
        "first_browser_name",
        "first_device_type",
        "last_seen"
      ],
      "sort": {
        "field": "first_seen",
        "order": "DESC"
      },
      "wildcard_search_term": "john"
    },
    "id": "query_users_request",
    "type": "query_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/query" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "limit": 25,
      "query": "user_email:*@techcorp.com AND first_country_code:US AND first_browser_name:Chrome",
      "select_columns": [
        "user_id",
        "user_email",
        "user_name",
        "user_org_id",
        "first_country_code",
        "first_browser_name",
        "first_device_type",
        "last_seen"
      ],
      "sort": {
        "field": "first_seen",
        "order": "DESC"
      },
      "wildcard_search_term": "john"
    },
    "id": "query_users_request",
    "type": "query_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/query" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "limit": 25,
      "query": "user_email:*@techcorp.com AND first_country_code:US AND first_browser_name:Chrome",
      "select_columns": [
        "user_id",
        "user_email",
        "user_name",
        "user_org_id",
        "first_country_code",
        "first_browser_name",
        "first_device_type",
        "last_seen"
      ],
      "sort": {
        "field": "first_seen",
        "order": "DESC"
      },
      "wildcard_search_term": "john"
    },
    "id": "query_users_request",
    "type": "query_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/query" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "limit": 25,
      "query": "user_email:*@techcorp.com AND first_country_code:US AND first_browser_name:Chrome",
      "select_columns": [
        "user_id",
        "user_email",
        "user_name",
        "user_org_id",
        "first_country_code",
        "first_browser_name",
        "first_device_type",
        "last_seen"
      ],
      "sort": {
        "field": "first_seen",
        "order": "DESC"
      },
      "wildcard_search_term": "john"
    },
    "id": "query_users_request",
    "type": "query_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/query" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "limit": 25,
      "query": "user_email:*@techcorp.com AND first_country_code:US AND first_browser_name:Chrome",
      "select_columns": [
        "user_id",
        "user_email",
        "user_name",
        "user_org_id",
        "first_country_code",
        "first_browser_name",
        "first_device_type",
        "last_seen"
      ],
      "sort": {
        "field": "first_seen",
        "order": "DESC"
      },
      "wildcard_search_term": "john"
    },
    "id": "query_users_request",
    "type": "query_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/query" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "limit": 25,
      "query": "user_email:*@techcorp.com AND first_country_code:US AND first_browser_name:Chrome",
      "select_columns": [
        "user_id",
        "user_email",
        "user_name",
        "user_org_id",
        "first_country_code",
        "first_browser_name",
        "first_device_type",
        "last_seen"
      ],
      "sort": {
        "field": "first_seen",
        "order": "DESC"
      },
      "wildcard_search_term": "john"
    },
    "id": "query_users_request",
    "type": "query_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/query" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "limit": 25,
      "query": "user_email:*@techcorp.com AND first_country_code:US AND first_browser_name:Chrome",
      "select_columns": [
        "user_id",
        "user_email",
        "user_name",
        "user_org_id",
        "first_country_code",
        "first_browser_name",
        "first_device_type",
        "last_seen"
      ],
      "sort": {
        "field": "first_seen",
        "order": "DESC"
      },
      "wildcard_search_term": "john"
    },
    "id": "query_users_request",
    "type": "query_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/query" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "limit": 25,
      "query": "user_email:*@techcorp.com AND first_country_code:US AND first_browser_name:Chrome",
      "select_columns": [
        "user_id",
        "user_email",
        "user_name",
        "user_org_id",
        "first_country_code",
        "first_browser_name",
        "first_device_type",
        "last_seen"
      ],
      "sort": {
        "field": "first_seen",
        "order": "DESC"
      },
      "wildcard_search_term": "john"
    },
    "id": "query_users_request",
    "type": "query_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/query" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "limit": 25,
      "query": "user_email:*@techcorp.com AND first_country_code:US AND first_browser_name:Chrome",
      "select_columns": [
        "user_id",
        "user_email",
        "user_name",
        "user_org_id",
        "first_country_code",
        "first_browser_name",
        "first_device_type",
        "last_seen"
      ],
      "sort": {
        "field": "first_seen",
        "order": "DESC"
      },
      "wildcard_search_term": "john"
    },
    "id": "query_users_request",
    "type": "query_users_request"
  }
}
EOF