Skip to content

Repository files navigation

Blitz Dashboard

The open-source LinkedIn intelligence dashboard.
Search people, enrich emails, export CSV — all through one UI.

Quick Start · Features · Deploy

License Stars Blitz API Book a Demo


Blitz Dashboard — AI-powered search with enrichment pipeline

Type "Find home services owners — CEOs, Presidents in the US" and get 50 verified leads with emails in under a minute.

Blitz Dashboard — Bulk email enrichment results


Features

Search across LinkedIn at scale — 12 Blitz API v2 endpoints. Company Search, Find People, Employee Finder, Waterfall ICP, Email/Phone/Company Enrichment, Domain lookups, Reverse lookups.

AI-powered query builder — Describe what you want in plain English. Claude generates the exact JSON payload with validated enum values, keyword reinforcement, and auto-fixed fields.

Bulk email enrichment — Search for people, click "Enrich Emails", get verified work emails for every result. Live progress bar, merged results table, one-click CSV download. Full run logged with stats (e.g. "31/50 emails found").

Auto-pagination — Fetch all pages automatically with a progress bar. Set a max results limit to control API credit spend.

Real-time validation — JSON editor validates against 534 industries, 22 job functions, 6 job levels, and all other Blitz API enums. Wrong values get amber warnings with clickable auto-fix suggestions.

Full audit trail — Every request + response saved to MongoDB. Browse logs, filter by endpoint, export individual or bulk results as structured CSV.

JWT auth — Optional email/password authentication via jose. Disabled when ALLOWED_EMAILS is not set.


Quick Start

git clone https://github.com/goforbg/blitz-dashboard.git
cd blitz-dashboard
cp .env.example .env    # Add your keys
npm install
npm run dev             # http://localhost:3000

Environment Variables

Variable Required Description
BLITZ_API_KEY Yes Your Blitz API key from app.blitz-api.ai
MONGODB_URI Yes MongoDB connection string
ALLOWED_EMAILS No Comma-separated emails for auth (auth disabled if not set)
AUTH_PASSWORD No Shared password for login
ANTHROPIC_API_KEY No Enables AI JSON generation (Claude)
AUTH_SECRET No JWT signing secret (defaults to BLITZ_API_KEY)

How It Works

1. AI JSON Generation

Type a natural language prompt:

"Find VPs of Engineering at SaaS companies in the US with 50-200 employees"

The AI generates a validated JSON payload with 3 layers of guardrails:

  • Prompt engineering — Always adds keywords.include to reinforce industry filters + keywords.exclude to filter noise
  • Post-generation validation — Auto-fixes invalid enum values (e.g. "vp" -> "VP", "Sales" -> "Sales & Business Development")
  • Real-time editor validation — Catches anything remaining with amber warnings + one-click fix

2. Search & Paginate

Send the request or click Run All Pages to fetch every page automatically. Set a max results limit (e.g. 200) to control costs. Supports cursor-based pagination (Company Search, Find People) and page-based (Employee Finder).

3. Enrich Emails (Daisy-Chain)

After a people search, click Enrich Emails to:

  1. Extract all LinkedIn URLs from search results
  2. Call /v2/enrichment/email for each profile (rate-limited at 250ms)
  3. Show a live progress bar and preview table
  4. Download as enriched CSV with name, title, company, email, domain

Every bulk enrichment run is logged with aggregate stats — total profiles, emails found, success rate, and full results.

Blitz Dashboard — Enrichment in progress

4. Export & Audit

  • Structured CSV exports — Endpoint-aware column mappings, not raw JSON dumps
  • Paginated log viewer — Browse all historical requests, filter by endpoint
  • Individual + bulk export — Export single responses, paginated results, or enriched datasets

API Routes

Route Description
POST /api/proxy Proxy to any Blitz API endpoint (logs to MongoDB)
POST /api/ai/generate AI JSON payload generation with validation + auto-fix
POST /api/logs/enrichment Save bulk enrichment summary with stats
GET /api/health Check API key validity and credits
GET /api/stats Aggregated request stats
GET /api/logs Paginated log viewer
GET /api/logs/export Export all logs as CSV
GET /api/logs/:id/export Export single log response as structured CSV
POST /api/auth/login Email/password login
POST /api/auth/logout Clear session

Testing

npm test

16 tests covering validation (enum checking, case sensitivity, fuzzy matching), pagination (cursor-based, page-based, max results), and enrichment pipeline (found/not-found handling).


Deploy to Railway

  1. Push to GitHub
  2. Create a Railway project, add a MongoDB service
  3. Connect your repo
  4. Set env vars: BLITZ_API_KEY, MONGODB_URI
  5. Optional: ALLOWED_EMAILS + AUTH_PASSWORD for auth, ANTHROPIC_API_KEY for AI

Need Help With Lead Gen at Scale?

This dashboard is built and maintained by InboxPirates — we're the implementation lead gen agency behind agentic enrichment pipelines, cold outbound infrastructure, and Blitz API integrations.

If you need help with:

  • Setting up automated enrichment workflows
  • Building agentic lead gen pipelines with Blitz API
  • Cold email infrastructure and deliverability
  • Custom dashboard deployments

Book a Demo with InboxPirates


Built With

Next.js 14 · MongoDB · Tailwind CSS · jose · Anthropic SDK · Vitest

License

MIT

About

The open-source LinkedIn intelligence dashboard for Blitz API — AI-powered search, bulk email enrichment, CSV export. Built by InboxPirates.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages