Twitter API rate limits: 429s, fixed.

import os, random, threading, time, requests
from concurrent.futures import ThreadPoolExecutor

API = "https://api.cheapxapi.com"
HEADERS = {"x-api-key": os.environ["CHEAPXAPI_KEY"]}
PER_SECOND = 2   # your limit: 2 for new accounts, 10 after the first top-up

class Throttle:
    """Spaces requests evenly so the whole process stays under PER_SECOND."""
    def __init__(self, per_second):
        self.gap, self.next, self.lock = 1 / per_second, 0.0, threading.Lock()

    def wait(self):
        with self.lock:
            now = time.monotonic()
            start = max(self.next, now)
            self.next = start + self.gap
        time.sleep(start - now)

throttle = Throttle(PER_SECOND)

def backoff(res, attempt):
    """Seconds to wait: Retry-After, then X's x-rate-limit-reset, then exponential."""
    if res is not None and res.headers.get("retry-after", "").isdigit():
        return int(res.headers["retry-after"]) + random.random()
    if res is not None and res.headers.get("x-rate-limit-reset", "").isdigit():
        return max(0, int(res.headers["x-rate-limit-reset"]) - time.time()) + 1
    return min(60, 2 ** attempt) + random.random()

def get(path, params, attempts=6):
    """GET with throttling and retries. Only for reads: never retry a post blindly."""
    for attempt in range(attempts):
        throttle.wait()
        try:
            res = requests.get(API + path, headers=HEADERS, params=params, timeout=75)
        except requests.ConnectionError:
            res = None
        if res is not None and res.status_code != 429 and res.status_code < 500:
            res.raise_for_status()
            return res.json()
        time.sleep(backoff(res, attempt))
    raise RuntimeError(f"{path} still failing after {attempts} attempts")

names = ["XDevelopers", "NASA", "SpaceX", "nytimes", "BBCWorld", "github"]
with ThreadPoolExecutor(max_workers=8) as pool:
    for user in pool.map(lambda n: get("/twitter/user/info", {"userName": n})["data"], names):
        print(f'{user["userName"]:<12} {user["followers"]:>12,} followers')