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.

Concurrent Requests

On top of the rate limits, the number of concurrent requests is capped on reporting endpoints.

There can only be up to 10 concurrent requests made to the /v1/networks/reporting/* endpoints. Subsequence concurrent requests will return an error.

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	1000
Affiliate	1000
Advertiser	1000

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