Skip to main content

Best practices

Pull data once per day​

Since data is typically only updated once per day, you should only need to call for new data once per day. We recommend calling for new data daily at 8am ET in order to allow for the latest data to be made available before the start of each workday. Polling more frequently returns the same data and counts against your request quota.

Expect weekly optimization recommendations​

Depending on customer configuration, optimization recommendations may only become available once per week. Customers typically request this configuration in order to allow the optimization time to take effect and have a material impact on results.

Cache OAuth tokens​

Client-credentials access tokens are valid until their expiry. Cache the token and reuse it across requests; request a new one shortly before it expires rather than on every call — the lifetime is returned in the expires_in field of the token response (see Authentication).

Respect the request timeout​

The Incremental API currently has a 30 second timeout for responses. If your request takes longer than 30 seconds, you will need to update the request to reduce complexity, most likely via adding pagination or reducing the existing page size:

  • Reduce the page limit and paginate through smaller pages.
  • Narrow the date range or filters.
  • Request fewer measures/dimensions per query.

Ask only for what you need​

GraphQL returns exactly the fields you select. Smaller selections are faster to resolve and cheaper to transfer — avoid copying whole example queries into production integrations if you only need a few fields.