skillstring
Filter by skill tag (e.g., "photography", "driving", "cleaning", "notary")
equipmentstring
Filter by equipment (e.g., "car", "drone", "camera")
languagestring
Filter by language ISO code (e.g., "en", "es", "zh")
locationstring
Filter by location. Use fully-qualified names for best results (e.g., "San Francisco, California, USA" not just "San Francisco"). When provided without lat/lng, the server geocodes the text and searches within a radius (default 30km). Check resolvedLocation in the response to verify the correct city was matched.
latnumber
Latitude for radius search (requires lng and radius)
lngnumber
Longitude for radius search (requires lat and radius)
radiusnumber
Search radius in kilometers (default: 30km). Works with both text location and explicit lat/lng coordinates.
max_ratenumber
Maximum hourly rate in USD. Humans who set rates in other currencies are auto-converted to USD for comparison.
available_onlyboolean
Only return humans who are currently available (default: true)
work_modeenum
Filter by work mode preference (REMOTE, ONSITE, or HYBRID)
verifiedenum
Filter by verification status. Use "humanity" to only return humans who have verified their identity via Gitcoin Passport (score >= 20).
min_experiencenumber
Minimum years of professional experience
fiat_platformstring
Filter by fiat payment platform the human accepts (e.g., "WISE", "PAYPAL", "VENMO", "REVOLUT", "CASHAPP", "ZELLE", "MONZO", "N26", "MERCADOPAGO")
payment_typeenum
Filter by accepted payment type (UPFRONT, ESCROW, or UPON_COMPLETION)
accepts_cryptoboolean
Filter to only show humans who have a crypto wallet set up and can accept USDC payments
degreestring
Filter by education degree (e.g., "Bachelor", "MBA", "PhD"). Partial match, case-insensitive.
fieldstring
Filter by field of study (e.g., "Computer Science", "Marketing"). Partial match, case-insensitive.
institutionstring
Filter by educational institution name (e.g., "MIT", "Oxford"). Partial match, case-insensitive.
certificatestring
Filter by certificate name or issuer (e.g., "AWS", "PMP", "Google"). Partial match, case-insensitive.
min_vouchesnumber
Only return humans vouched for by at least this many other users.
has_verified_loginboolean
Only return humans who have verified their identity via an OAuth provider (Google, LinkedIn, or GitHub). Does not reveal which provider.
has_photoboolean
Only return humans with an approved profile photo.
sort_byenum
Sort results by: "completed_jobs" (humans with platform experience first), "rating" (highest rated first), "experience" (most years of professional experience first), "recent" (most recently active first). Default sorts by completed jobs, then rating, then experience.
min_completed_jobsnumber
Only return humans who have completed at least this many jobs on the platform. Use min_completed_jobs=1 to find all workers with any platform track record. Works with or without other filters — no skill filter needed.
min_channelsnumber
Only return humans with at least this many notification channels active (0-4). Channels: email, telegram, whatsapp, push. Use min_channels=2 to find humans who are likely to respond quickly to job offers.
