One-time Queries

One-time queries are good for pulling data over custom date ranges. One-time queries must be submitted anew for every unique run if your team wants to run the same report (using the same metrics, dimensions, and/or filters) over unique date ranges (using unique start and end date parameters).
Getting data back from a one-time query is a three-step process using each of the below one-time API endpoints:
1.Run a /submit/ call to submit your new query and receive a query ID.
2.Run a /status/ call to check the status of your submitted query using the query ID from your previous call to the /submit/ endpoint. Continue running as frequently as every ten seconds or so until you receive a completed status for your query.
3.Once the status of your query is completed, run a /fetch/ call with the original query ID to download your completed query results.
get
https://api.chartbeat.com
/query/v2/submit/
Submit One-time Query
get
https://api.chartbeat.com
/query/v2/status/
Get Status of One-time Query
get
https://api.chartbeat.com
/query/v2/fetch/
Fetch One-time Query

Getting Started with our Historical API

Recurring Queries

Last modified 9mo ago

Copy link

Contents

get

Submit One-time Query

get

Get Status of One-time Query

get

Fetch One-time Query