Query profiles

Query profiles

Returns the user or group profiles that match a selector expression or belong to a cohort.

Note: Returns at most page_size profiles per response: for the next page, pass the first response's session_id with an incremented page.

Set up

Use the first option your agent supports.

API (official)

• Base URL: https://mixpanel.com/api/query
• Endpoint: POST /engage
• Auth: send the header Authorization: Basic $MIXPANEL_SA_TOKEN
• Get a key: https://mixpanel.com/settings/org#serviceaccounts
• Docs: https://docs.mixpanel.com/reference/query-api

Note: MIXPANEL_SA_TOKEN holds the base64 of <service account username>:<secret>, and every request carries project_id; EU and India projects use eu.mixpanel.com and in.mixpanel.com.

Before anything else, confirm access with the cheapest read-only call, like a list or a search. Never send or change anything to test access.

Rules

• Ask the user before anything that sends messages, costs money, or changes data, and say how many records it touches. One approval covers a batch the user has seen.
• Never print API keys.