Documented steps

Authenticate with a personal API key that has the Query Read permission: header Authorization: Bearer $POSTHOG_PERSONAL_API_KEY.
POST to https://us.posthog.com/api/projects/:project_id/query/ (or eu.posthog.com for EU Cloud) with Content-Type: application/json.
Body: { "query": { "kind": "HogQLQuery", "query": "SELECT ... FROM events WHERE ..." } }. Other supported kinds include EventsQuery, TrendsQuery, FunnelsQuery.
Optionally set refresh to control execution/caching: blocking (default), async, force_blocking, force_async, force_cache, lazy_async, or async_except_on_cache_miss.
For async modes, the initial response returns a query status object with an id; poll GET /api/projects/:project_id/query/:query_id/ until complete.
Add your own LIMIT in the HogQL: default is only 100 rows; an explicit LIMIT can return up to 50k rows per query.
Docs: https://posthog.com/docs/api/queries

Known gotchas

Query endpoint limits per project: 2400 requests/hour, 240/minute, max 3 concurrent queries, 60 threads per query.
Max execution time is 10 seconds — longer HogQL is killed; optimize or break the query up.
Default row limit is 100 if you omit LIMIT — easy to silently under-fetch.
The personal API key needs the Query Read permission specifically, distinct from other resource scopes.
In async mode, the first POST response is a status object, not results — you must poll the query_id sub-resource.

google-search-console · 5 steps · unrated

Query Salesforce Big Objects with SOQL-style async queries and understand the indexing constraints

developer.salesforce.com · 6 steps · unrated

Query and mutate Vetspire practice data via its GraphQL API while respecting the maximum query depth limit

developer.vetspire.com · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans

Run a HogQL/SQL analytics query against PostHog data via the query API, including async execution and row limits

Documented steps

Known gotchas

Related routes

Give your agent this knowledge — and 15,500+ more routes

Need this verified for your stack — or a route we don't have yet?