drop-in replacement for Bluesky's app.bsky.actor.searchActorsTypeahead endpoint. any atproto app can point at this instead of public.api.bsky.app and get actor search without depending on Bluesky's infrastructure.

curl "https://typeahead.waow.tech/xrpc/app.bsky.actor.searchActorsTypeahead?q=nate&limit=10"

how it works#

ingester (zig) subscribes to Jetstream, filters identity and profile events, batches them to the worker
worker (cloudflare) serves search via FTS5 full-text search over D1, with edge caching (60s) and rate limiting
backfill fills index gaps by querying Bluesky's typeahead in the background — temporary bridge while the index catches up

stack#

ingester: zig on fly.io — streams jetstream, posts batches to worker
worker: cloudflare worker + D1 (sqlite/FTS5) + KV + cache API
search: FTS5 prefix matching, edge-cached per query

run locally#

# worker
npm install
npx wrangler dev

# ingester
cd ingester && zig build run

requires TYPEAHEAD_URL and TYPEAHEAD_SECRET env vars for the ingester.

deploy#

npx wrangler deploy                    # worker to cloudflare
cd ingester && fly deploy              # ingester to fly.io

known limitations#

response shape: returns did, handle, displayName, avatar. does not yet include associated, labels, createdAt, or other fields from profileViewBasic. apps that only destructure the core fields work fine; apps that depend on labels or associated metadata should be aware of this gap.
no moderation filtering: results are not filtered by moderation labels. unsafe accounts may appear in results.
index coverage: the index grows from jetstream events + backfill. it does not yet have full coverage of all atproto actors.

license#

MIT

Configure Feed