Architecture & Key Constraints
The Next.js app is separate from the Elysia API. Redis caches responses. Zod and Prisma keep a missing price from breaking the row.
Two programs
The interface is a Next.js app. You enter a ZIP code or a Zillow search URL, review listings in a table, and export CSV or JSON. Cloudflare Turnstile runs before a search. rate-limiter-flexible gives a public request a smaller allowance than a request that includes an API key. Zod and Prisma normalize each listing on the way into PostgreSQL, so a row can be missing a price or an area.
The scraper is a separate Elysia service. POST /scraper takes a zipcode or a Zillow URL, a page, an allPages flag, and a filter of sale, sold, or rent. Callers send Authorization: Bearer or X-API-Key. OpenAPI docs are at /docs.
Cache and retries
Redis is a write-through cache with a one-hour TTL and 15 percent jitter. It is not the job queue. bypassCache skips the read and still writes the fresh response. p-retry repeats a failed request. A proxy URL or a proxy list can be set in the environment.
The live tool is at zillow-scraper-farhan.vercel.app.



