Frequently Asked Questions
Common questions about using the Ad Insights API.
How do I authenticate?
The API uses token authentication. Pass your token in the Authorization header on every request. The header is required on all endpoints.
Are there rate limits?
The API allows 1 request per second per account. Retries on rate-limit errors are safe and do not count against quota.
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.