Skip to main content

Frequently Asked Questions

Common questions about using the Ad Insights API.

How do I authenticate?​

The API uses a GameAnalytics personal access token (PAT). Send the PAT in the Authorization header of each request, with the Bearer scheme:

Authorization: Bearer ga_pat.<id>.<key>

The header is necessary on all endpoints.

Are there rate limits?​

The API allows 1 request per second per user. If you send more, the API returns 429 with the code too_many_requests. Wait for the time in the Retry-After header, then try again. A request that the rate limit stops does not count against the monthly quota.

Is there a monthly quota?​

Each user has a quota of successful requests for each calendar month (UTC), for each organization. A failed request does not count against this quota. The quota starts again at the start of each month.

Each response includes these headers, so that you can monitor your usage:

  • x-quota-limit: the number of successful requests that you can send in one month.
  • x-quota-remaining: the number of successful requests that remain this month.
  • x-quota-reset: the time when the quota starts again, as a Unix timestamp in seconds.

When you use all of the quota, the API returns 429 with the code quota_exceeded.

How can I see the usage of my team?​

An owner or an admin of the organization can send GET /v1/orgs/{org_id}/adinsights/usage. The response gives the number of successful requests that each user sent in the current month. This request does not count against the quota. Refer to the API specification for more information.

What are the query limits?​

  • 100 results per call (pagination limit)
  • Top 10,000 results ceiling per ranked query. Partition by date, country, industry, or OS to access longer tails.
  • 30-day maximum date window per query. Longer historical ranges are accessible via sequential queries.

Can I download creative assets directly?​

Yes. The Creative Data API returns direct downloadable URLs for asset files (MP4 for video, HTML for playables, image files). URLs are valid for 6 months from generation, so pipelines can process assets without needing to refresh URLs mid-workflow.

Are runnable code samples available?​

Yes. Sample requests and responses are included in the API specification. If you are evaluating specific use cases, contact us to receive tailored sample queries for your workflow.

Does the API support webhooks or push delivery?​

The API is currently pull-based only. You poll on your preferred cadence.

Can multiple team members share access?​

Yes. Subscriptions include team access, so multiple authorized users can share access under a single subscription. Contact us to discuss requirements for larger teams.

Is caching applied to repeated queries?​

No. Every query counts as one API call, including identical queries issued in quick succession. If you want to reduce call volume, implement client-side caching for your own use cases.