improved

Improved API complexity calculation

🏷️ API version: 2025-10

We’ve improved how query complexity is calculated and charged:

  • Complexity is now estimated based on the variables you provide. We charge what we think the query will cost, and once the results are returned, you are reimbursed or charged according to the actual cost. If needed, adjustments are made from the following minute’s allowance.
  • Failed queries/errors now cost significantly less.
  • The complexity error format has been updated (read more here).

For many queries, this means that you'll get points back rather than being charged more. These changes make complexity easier to predict and better aligned with API best practices.