Rate limits

Each key has a per-minute budget per request class. Each account also has a shared budget, so adding keys doesn't multiply what an account can send. A request must fit both budgets.

Your agreement may set different limits. The headers are the source of truth for your key.

Budgets are token buckets. A full minute's budget can be spent in a burst, and it refills continuously.

HeadersCopy Anchor Link

Every authenticated response carries:

When you hit the limitCopy Anchor Link

You get 429 with code rate_limited and a Retry-After header in seconds. Wait that long and retry.

import time
import requests

def get(session, url, **kw):
    for _ in range(5):
        r = session.get(url, **kw)
        if r.status_code != 429:
            return r
        time.sleep(int(r.headers.get("Retry-After", "1")))
    return r

Spending lessCopy Anchor Link

• Use conditional requests. A 304 still counts, but it carries no body.
• Use bulk exports for whole days of history instead of paging through feeds.
• Most data changes at the provider's polling interval (15 to 60 minutes). Polling the same route more often than once a minute gets you the same data.