Tutorial

How to Build a Boolean Job Search Using Real APIs

An r/hiringcafe post struggled with boolean filters. Walk-through to build the same boolean search via Scavio dorks + LLM filtering.

An r/hiringcafe post tried to filter jobs by 'a/b testing OR growth OR CRO' inside the entire job description and got no results. This walks the same boolean search via Scavio dorked search + LLM filtering.

Prerequisites

  • Scavio API key
  • LLM API key
  • A list of target career page domains (or use Scavio dorks generically)

Walkthrough

Step 1: Define the boolean criteria as a list

Plain English, machine-parseable.

JavaScript
// criteria = ['a/b testing', 'growth', 'conversion rate optimization', 'CRO']
// roles = ['software engineer', 'product manager', 'growth engineer']

Step 2: Generate Scavio dorks per criterion

Cross-product of role × criterion × geography.

Text
// 'site:lever.co "<role>" "<criterion>" "<location>"'
// 'site:greenhouse.io "<role>" "<criterion>"'
// 'site:jobs.<company>.com "<role>" "<criterion>"'

Step 3: Run Scavio per dork

Collect URLs + snippets.

Text
// POST https://api.scavio.dev/api/v1/search
// Body: { query: dork }
// Collect organic_results.link + snippet

Step 4: Per URL: Scavio /extract or LLM-on-snippet

Verify the criterion is in the JD.

Text
// For top 50 URLs: scavio_extract for full job description
// LLM: 'Does this JD contain ANY of [a/b testing, growth, CRO]? Return JSON { match: bool, criteria_found: [...] }'

Step 5: Filter to true matches

Drop snippet false positives.

Text
// Snippet match without full-JD verification = noise.

Step 6: Output: ranked list with criterion-found tags

End-user filter.

Text
// CSV / JSON: { title, company, location, salary?, url, criteria_found: [...] }

Python Example

Python
# Per-search: 5-10 dorks × 1 Scavio + 50 URL extractions × 1 LLM = ~$0.50-2 per boolean search batch.

JavaScript Example

JavaScript
// Same in TS.

Expected Output

JSON
Working boolean job search returning real matches across multiple ATS sources, criterion-tagged.

Related Tutorials

Frequently Asked Questions

Most developers complete this tutorial in 15 to 30 minutes. You will need a Scavio API key (free tier works) and a working Python or JavaScript environment.

Scavio API key. LLM API key. A list of target career page domains (or use Scavio dorks generically). A Scavio API key gives you 500 free credits per month.

Yes. The free tier includes 500 credits per month, which is more than enough to complete this tutorial and prototype a working solution.

Scavio has a native LangChain package (langchain-scavio), an MCP server, and a plain REST API that works with any HTTP client. This tutorial uses the raw REST API, but you can adapt to your framework of choice.

Start Building

An r/hiringcafe post struggled with boolean filters. Walk-through to build the same boolean search via Scavio dorks + LLM filtering.