dailydotsnek

A small, friendly Python client for the daily.dev public API.
Feeds, posts, bookmarks, profile tools, and search — with rate-limit-aware GET retries.

Get started

python -m pip install dailydotsnek

The SDK requires Python 3.10 or later. It installs its HTTP and .env dependencies automatically.

Your first request

Create a .env file in your project directory:

DAILY_DEV_KEY=your_daily_dev_api_token

Keep this file private: do not commit API tokens to source control.

from snek.snekSDK import SnekSDK
from snek.tokenSys import AutoApiToken

client = SnekSDK(AutoApiToken())
popular_posts = client.getPopularFeed()

print(popular_posts)
print("Remaining requests:", client.getRateRemaining())

Prefer explicit secret management? Pass the token directly:

from snek.snekSDK import SnekSDK
from snek.tokenSys import ManualApiToken

client = SnekSDK(ManualApiToken("your_daily_dev_api_token"))

Rate limits, handled thoughtfully

When daily.dev returns HTTP 429 Too Many Requests, the SDK automatically waits for the server's Retry-After value and retries GET requests up to three times. If the header is missing or invalid, it uses a short exponential delay. It does not automatically replay POST, PUT, PATCH, or DELETE requests, so a write is never silently duplicated.

If a request still cannot proceed, the SDK raises RateLimitError, a requests.HTTPError subclass. It includes the original response and a suggested retry_after wait:

from snek.rawFetch import RateLimitError

try:
    posts = client.getPopularFeed()
except RateLimitError as error:
    print(f"Rate limit reached. Try again in {error.retry_after} seconds.")

Rate-limit helpers report headers from the most recent API response. They return None before the first request or when that response did not include the requested header.

What’s included

Documentation

Explore the full documentation, including the installation guide, quickstart and error handling, API reference, and publishing guide.

To preview the documentation site locally:

python -m pip install mkdocs-material
python -m mkdocs serve