Quotas and limits

Two independent controls apply: per-endpoint rate limits and a rolling 24-hour run quota.

Rate limits

Limits apply at seat level. Two tokens on the same seat share the same limit.

Run quota

You can run 75 reports in a rolling 24-hour window by default. After that, you cannot start more runs until slots free up. Creating or editing saved reports in TAM does not consume quota; running them does.

Contact your Teads account representative if you need a higher quota.

Affected routes:

• POST /api/reports/run
• POST /api/reports/:id/run

Check usage before bursting:

GET /api/reports/quotas
Authorization: YOUR_API_KEY

A 429 on a run endpoint means the quota (or the 30-second rate limit) was hit. The one-time-report error body can look like:

{
  "error": {
    "message": "Error message",
    "details": []
  }
}

Possible messages include required parameters missing, and User X reached its Api quota CURRENT_QUOTAS / TOTAL.

Date and data availability

Unique Viewers

uv_impression is only valid with a fixed set of dimensions and metrics. See Unique Viewers.