Rate Limiting

Rate Limiting

The Everflow API is subject to per entity rate limits

Quotas

The following table details the request limits for each type of entity. The quotas are shared between all users of entity. For example, different network employee api keys from a network count towards the same quota.

User Queries per second
Network 20
Affiliate 5
Advertiser 5

Rate Limiting

Rate limiting resets every 30 seconds. Every request contains the following headers:

Header Purpose
X-RateLimit-Limit The number of requests you can make each 30 seconds
X-RateLimit-Remaining The number of requests you can still make for the current 30 seconds window

Once you reach your limit, requests will all return a 429 error code until your 30 seconds window resets.

BigQuery Quotas

Most of the reporting endpoints in Everflow gets data in MySQL, but some data are only available in BigQuery. Calls using BigQuery are limited by hour. Please note that the Affiliate and Advertiser quotas is applicable to all activities at the network level, not per affiliate / advertiser.

User Queries per hour
Network 500
Affiliate 500
Advertiser 500

Important : The number of queries is rate limited per period of 60 minutes but doesn’t necessarily match the start and end of the hour. Rate limiting will kick in whenever the number of requests exceeds the limit over any rolling period of 60 minutes.

If a call contains at least one of the following columns, it is made in BigQuery.

Geolocation:

Country, Region, City, DMA, Carrier, ISP, Connection Type

Device:

Platform, OS Version, Device Type, Browser, Device Brand, Language, Device Model

Misc:

Adv1, Avd2, Adv3, Adv4, Adv5, Sub1, Sub2, Sub3, Sub4, Sub5, Source ID, Referrer