Freestar has implemented an SDK that allows our publishers to easily integrate with our system and lets them query their daily revenue for both the Header Bidding container and the Freestar Server-to-Server demand (formerly Sortable Server-to-Server demand). For technical guidance on how to use the API, go here.
In preparation for anticipated growth, we have set rate limits for API users to both manage the load in our service and to educate publishers about our service boundaries so that they can design their API client more efficiently.
| Limit | Description | Error Codes |
|---|---|---|
| Maximum number of rows per report | 500,000 | 500 (Limit Exceeded) |
| Maximum size of a report | 1 GB | 500 (Limit Exceeded) |
| Request rate limit | 10 requests / 10 second (Not 1 r/s) | 429 (Too many requests) |
| Maximum number of concurrent reports | 3 | 429 (Too many requests) |
| Time to retrieve cached reports | 24 hours | 404 (Not found) |
If a client is restricted by one of the above limits, it can be resolved by:
- Requesting only the data that you need
- Using filter conditions to restrict the report;
- Using fewer dimensions or metrics, or a narrower time range; or
- Waiting a few seconds between requests to the API
For industry insights and information about our product offerings, check out our blog! Want to see our products in action? For a demo, fill out a form here.
