Minimal Python client

1. 01Drop into your project as fundedapi.py.
2. 02Auto-retries on 429 using our X-RateLimit-Reset header.

import requests, time, os

class FundedAPI:
    BASE = "https://fundedapi.com"

    def __init__(self, key: str | None = None):
        self.key = key or os.environ["FUNDED_API_KEY"]
        self.s = requests.Session()
        self.s.headers["Authorization"] = f"Bearer {self.key}"

    def _req(self, method, path, **kw):
        for attempt in range(3):
            r = self.s.request(method, self.BASE + path, **kw)
            if r.status_code == 429:
                reset = int(r.headers.get("X-RateLimit-Reset", time.time() + 60))
                time.sleep(max(1, reset - int(time.time())))
                continue
            r.raise_for_status()
            return r.json()
        r.raise_for_status()

    def search(self, **filters):
        return self._req("GET", "/v1/startups", params=filters)

    def ai_search(self, query: str):
        return self._req("POST", "/v1/search/ai", json={"query": query})

    def get(self, startup_id: str):
        return self._req("GET", f"/v1/startups/{startup_id}")

# usage
api = FundedAPI()
print(api.search(niche="AI", hiring=True, limit=5))
print(api.ai_search("Seed AI startups hiring in SF"))

• ▸A FundedAPI key (free). Grab one.
• ▸Set FUNDED_API_KEY in your environment.
• ▸Read the API reference if you need other endpoints.