Input

Type

Required

Notes

mode

enum

no

What to run. enrich_companies resolves identity, firmographics, LinkedIn and social for each company. discover_jobs finds who is hiring for your keywords and resolves the real employer from the job description. find_contacts finds people at each company. full chains all three.

domains

array

no

One domain per line. Used by enrich_companies and find_contacts.

company_names

array

no

One name per line. Used when you have a name but no domain.

keywords

array

no

Roles to search for. Used by discover_jobs and full. Example: copy editor, proofreader, content editor.

country

string

no

Two letter country code for job search, for example us or gb.

location

string

no

Optional location filter for job search, for example New York.

lookback_days

string

no

Drop postings older than this many days. Sent as a string because Clay sends every field as a string.

max_results

string

no

Cap on postings returned per run. Keeps a broad keyword set from running away.

max_pages

string

no

1 to 5. Each page is one SerpAPI call, so this is the main cost dial on discovery.

new_postings_only

string

no

true to return only postings not seen in a previous run.

previous_run_date

string

no

YYYY-MM-DD watermark for delta detection when the cross-run cache is unavailable.

remote_only

string

no

true to keep only postings flagged remote by the board.

company_size_min

string

no

Drop companies below this headcount. Only takes effect once headcount is known, so it applies in full mode and to any discovery row that carried an employee count. Discovery alone does not enrich.

company_size_max

string

no

Drop companies above this headcount. Same condition as the minimum.

exclude_staffing

string

no

true to drop postings from staffing and recruitment agencies.

exclude_marketplaces

string

no

true to drop Upwork, Fiverr, Freelancer and similar gig listings.

extra_marketplaces

array

no

Additional marketplace names to filter out.

fetch_posting_page

string

no

true to open the job posting when the description alone does not identify the employer. Slower, and it is what catches a job board posting on an employer's behalf.

target_contacts

string

no

1 to 25.

job_titles

array

no

Titles to search for when finding contacts.

seniority

array

no

c_level, vp, director, manager, senior.

departments

array

no

marketing, sales, engineering, product, finance, hr, operations, legal.

include_email

string

no

true to run the email waterfall. Needs an Icypeas or Prospeo key, which you supply and are billed for directly.

verify_email

string

no

true to verify each address. Needs a Reoon or BounceBan key.

score_icp

string

no

true to score every row against the ICP rules and tier it A to D.

icp_preset

enum

no

Which scoring model to apply. "proofed_editorial" scores for a seller of managed copy editing and proofreading. "generic_b2b" scores on hiring intent, employer resolvability and headcount with no service-specific vocabulary.

min_icp_score

string

no

In full mode, only companies scoring at or above this go on to contact discovery. Default 45: at 25 the filter passed every keyword-discovered editorial posting, because 25 is the floor such a posting can score.

extra_exclude_names

array

no

Any company whose name contains one of these is excluded.

signal_taxonomy

array

no

Override the default signal types. Each entry is an object with type, strength, title_keywords, and optional also_keywords and description_keywords.

include_social

string

no

true to resolve Facebook, Instagram, X and YouTube alongside LinkedIn.

source_timeout_secs

string

no

5 to 120. A source that exceeds this is marked degraded and the run continues.

skip_cache

string

no

true to ignore the 7 day cross-run cache and recompute everything.

serper_api_key

string

no

Your Serper.dev key. Powers people search in find_contacts, which is the highest-coverage layer. Without it the free fallback is measurably poor.

findymail_api_key

string

no

Your Findymail key. First provider in the email waterfall.

icypeas_api_key

string

no

Your Icypeas key. Runs on Findymail misses.

prospeo_api_key

string

no

Your Prospeo key. Runs on the residual after Findymail and Icypeas.

reoon_api_key

string

no

Your Reoon key. First email verification provider.

bounceban_api_key

string

no

Your BounceBan key. Second verifier, used for the catch-all case.

serpapi_key

string

no

Your SerpApi key. Required by discover_jobs and full. Distinct from a Serper key: different vendor.