{"uid":"cap_ufF5J0wMQaYeZ4SSPeA72","slug":"withzero-wiza-prospect-list-builder-e043d3b8","name":"WithZero Wiza Prospect List Builder","description":"Create an enriched Wiza prospect list from search filters, including company-name aliases normalized to Wiza job_company. Capped at 30 profiles per call; payment escrow is sized from list.max_profiles and final settlement comes from Wiza list api_credits.total.","url":"https://agents.withzero.xyz/api/v1/wiza/prospect-lists?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","example":{"list":{"name":"US founders sample","max_profiles":3},"filters":{"job_title":[{"v":"founder"}]}},"required":["list","filters"],"properties":{"list":{"type":"object","required":["name","max_profiles"],"properties":{"name":{"type":"string","minLength":1,"description":"Name of the prospect list."},"callback_url":{"type":"string","format":"uri","description":"Optional Wiza webhook URL for asynchronous completion updates."},"max_profiles":{"type":"integer","maximum":30,"minimum":1,"description":"Number of prospects to enrich. Capped at 30 for bounded metered pricing."},"email_options":{"type":"object","properties":{"accept_work":{"type":"boolean","description":"Return professional email addresses such as tim.cook@apple.com."},"accept_generic":{"type":"boolean","description":"Return generic role addresses such as hello@apple.com."},"accept_personal":{"type":"boolean","description":"Return personal email addresses such as tcook1960@gmail.com."}},"description":"Types of emails Wiza may return for list-style enrichment.","additionalProperties":false},"skip_duplicates":{"type":"boolean","description":"Skip contacts previously found in other API lists."},"enrichment_level":{"enum":["none","partial","full"],"type":"string","description":"none = profile data only; partial = emails; full = emails and phone numbers. Defaults to partial."}},"additionalProperties":false},"filters":{"type":"object","properties":{"major":{"type":"array","items":{"type":"string"},"description":"Majors to match."},"skill":{"type":"array","items":{"type":"string"},"description":"Skills to match."},"school":{"type":"array","items":{"type":"string"},"description":"Exact school names."},"company":{"type":"array","items":{"anyOf":[{"type":"object","required":["v"],"properties":{"s":{"enum":["i","e"],"type":"string","description":"Use \"i\" to include or \"e\" to exclude. Defaults to include when omitted."},"v":{"type":"string","minLength":1,"description":"Filter value."}},"additionalProperties":false},{"type":"string","minLength":1}]},"description":"Alias for job_company. Use this when targeting prospects at specific current companies."},"revenue":{"type":"array","items":{"enum":["$0-$1M","$1M-$10M","$10M-$25M","$25M-$50M","$50M-$100M","$100M-$250M","$250M-$500M","$500M-$1B","$1B-$10B","$10B+"],"type":"string"}},"job_role":{"type":"array","items":{"enum":["customer_service","design","education","engineering","finance","health","human_resources","legal","marketing","media","operations","public_relations","real_estate","sales","trades"],"type":"string"},"description":"Functional roles."},"location":{"type":"array","items":{"type":"object","required":["v","b"],"properties":{"b":{"enum":["city","state","country"],"type":"string","description":"Location type."},"s":{"enum":["i","e"],"type":"string","description":"Use \"i\" to include or \"e\" to exclude. Defaults to include when omitted."},"v":{"type":"string","minLength":1,"description":"Location name. City format: \"city, state, country\"; state format: \"state, country\"; country format: \"country\"."}},"additionalProperties":false},"description":"Prospect locations to include or exclude."},"job_title":{"type":"array","items":{"type":"object","required":["v"],"properties":{"s":{"enum":["i","e"],"type":"string","description":"Use \"i\" to include or \"e\" to exclude. Defaults to include when omitted."},"v":{"type":"string","minLength":1,"description":"Filter value."}},"additionalProperties":false},"description":"Job titles to include or exclude. Wrap a title in quotes for exact title matching."},"last_name":{"type":"array","items":{"type":"string"},"description":"Exact last-name matches."},"first_name":{"type":"array","items":{"type":"string"},"description":"Exact first-name matches."},"funding_max":{"type":"string"},"funding_min":{"type":"string"},"job_company":{"type":"array","items":{"anyOf":[{"type":"object","required":["v"],"properties":{"s":{"enum":["i","e"],"type":"string","description":"Use \"i\" to include or \"e\" to exclude. Defaults to include when omitted."},"v":{"type":"string","minLength":1,"description":"Filter value."}},"additionalProperties":false},{"type":"string","minLength":1}]},"description":"Current company names to include or exclude. Strings are accepted and normalized to include filters."},"company_name":{"type":"array","items":{"anyOf":[{"type":"object","required":["v"],"properties":{"s":{"enum":["i","e"],"type":"string","description":"Use \"i\" to include or \"e\" to exclude. Defaults to include when omitted."},"v":{"type":"string","minLength":1,"description":"Filter value."}},"additionalProperties":false},{"type":"string","minLength":1}]},"description":"Alias for job_company. Use this when targeting prospects at specific current companies."},"company_size":{"type":"array","items":{"enum":["1-10","11-50","51-200","201-500","501-1000","1001-5000","5001-10000","10001+"],"type":"string"}},"company_type":{"type":"array","items":{"enum":["private","public","educational","government","nonprofit","public_subsidiary"],"type":"string"}},"funding_date":{"type":"object","required":["t","v"],"properties":{"t":{"enum":["last","any"],"type":"string","description":"Match the last funding event or any funding event."},"v":{"type":"string","minLength":1,"description":"Wiza funding value such as 60d, 90d, 1y, seed, series_a, or venture depending on the field."}},"additionalProperties":false},"funding_type":{"type":"object","required":["t","v"],"properties":{"t":{"enum":["last","any"],"type":"string"},"v":{"type":"array","items":{"enum":["angel","venture","grant","debt_financing","private_equity","crowdfunding","other"],"type":"string"}}},"additionalProperties":false},"job_sub_role":{"type":"array","items":{"type":"string"},"description":"Wiza job sub-role values such as software, recruiting, customer_success, product, or data."},"past_company":{"type":"array","items":{"anyOf":[{"type":"object","required":["v"],"properties":{"s":{"enum":["i","e"],"type":"string","description":"Use \"i\" to include or \"e\" to exclude. Defaults to include when omitted."},"v":{"type":"string","minLength":1,"description":"Filter value."}},"additionalProperties":false},{"type":"string","minLength":1}]},"description":"Past company names to include or exclude. Strings are accepted and normalized to include filters."},"business_name":{"type":"array","items":{"anyOf":[{"type":"object","required":["v"],"properties":{"s":{"enum":["i","e"],"type":"string","description":"Use \"i\" to include or \"e\" to exclude. Defaults to include when omitted."},"v":{"type":"string","minLength":1,"description":"Filter value."}},"additionalProperties":false},{"type":"string","minLength":1}]},"description":"Alias for job_company. Use this when targeting prospects at specific current companies."},"funding_stage":{"type":"object","required":["t","v"],"properties":{"t":{"enum":["last","any"],"type":"string"},"v":{"type":"array","items":{"enum":["pre_seed","seed","series_a","series_b","series_c","series_d","series_e-j","other"],"type":"string"}}},"additionalProperties":false},"linkedin_slug":{"type":"array","items":{"type":"string"},"description":"LinkedIn profile slugs or full LinkedIn profile URLs."},"company_summary":{"type":"array","items":{"anyOf":[{"type":"object","required":["v"],"properties":{"s":{"enum":["i","e"],"type":"string","description":"Use \"i\" to include or \"e\" to exclude. Defaults to include when omitted."},"v":{"type":"string","minLength":1,"description":"Filter value."}},"additionalProperties":false},{"type":"string","minLength":1}]},"description":"Words to include or exclude in the company summary. Strings are accepted and normalized to include filters."},"current_company":{"type":"array","items":{"anyOf":[{"type":"object","required":["v"],"properties":{"s":{"enum":["i","e"],"type":"string","description":"Use \"i\" to include or \"e\" to exclude. Defaults to include when omitted."},"v":{"type":"string","minLength":1,"description":"Filter value."}},"additionalProperties":false},{"type":"string","minLength":1}]},"description":"Alias for job_company. Use this when targeting prospects at specific current companies."},"department_size":{"type":"array","items":{"type":"string"},"description":"Department headcount filters such as \"sales:10-50\", \"engineering:10-\", or \"marketing:-50\"."},"job_title_level":{"type":"array","items":{"enum":["CXO","Director","Entry","Manager","Owner","Partner","Senior","Training","Unpaid","VP"],"type":"string"},"description":"Seniority levels."},"company_industry":{"type":"array","items":{"anyOf":[{"type":"object","required":["v"],"properties":{"s":{"enum":["i","e"],"type":"string","description":"Use \"i\" to include or \"e\" to exclude. Defaults to include when omitted."},"v":{"type":"string","minLength":1,"description":"Filter value."}},"additionalProperties":false},{"type":"string","minLength":1}]},"description":"Company industries to include or exclude, using Wiza industry values. Strings are accepted and normalized to include filters."},"company_location":{"type":"array","items":{"type":"object","required":["v","b"],"properties":{"b":{"enum":["city","state","country"],"type":"string","description":"Location type."},"s":{"enum":["i","e"],"type":"string","description":"Use \"i\" to include or \"e\" to exclude. Defaults to include when omitted."},"v":{"type":"string","minLength":1,"description":"Location name. City format: \"city, state, country\"; state format: \"state, country\"; country format: \"country\"."}},"additionalProperties":false},"description":"Company locations to include or exclude."},"last_funding_max":{"type":"string"},"last_funding_min":{"type":"string"},"year_founded_end":{"type":"string"},"year_founded_start":{"type":"string"},"company_annual_growth":{"enum":["0-5%","5-10%","10-20%","20-50%","50-100%","100%+"],"type":"string"}},"description":"Wiza prospect search filters. Additional Wiza-documented filter fields are accepted and forwarded.","additionalProperties":{}},"max_wait_ms":{"type":"integer","maximum":60000,"minimum":1,"description":"Maximum time to poll Wiza before returning a timeout if the upstream job is still queued/running. Defaults to 25000."},"wait_for_result":{"type":"boolean","const":true,"description":"Poll Wiza status endpoints before returning. Metered Wiza routes require this to stay true so billing can settle from final credit usage."},"poll_interval_ms":{"type":"integer","maximum":10000,"minimum":500,"description":"Delay between Wiza status polls. Defaults to 2000."}},"additionalProperties":false},"responseSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"data":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"},"stats":{"type":"object","properties":{"people":{"type":"number"},"credits":{"type":"object","properties":{"api_credits":{"anyOf":[{"type":"object","properties":{"total":{"type":"number"},"email_credits":{"type":"number"},"phone_credits":{"type":"number"},"scrape_credits":{"type":"number"},"company_credits":{"type":"number"}},"additionalProperties":{}},{"type":"null"}]}},"additionalProperties":{}}},"additionalProperties":{}},"status":{"type":"string"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"finished_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"report_type":{"type":"string"},"email_options":{"type":"object","properties":{"accept_work":{"type":"boolean","description":"Return professional email addresses such as tim.cook@apple.com."},"accept_generic":{"type":"boolean","description":"Return generic role addresses such as hello@apple.com."},"accept_personal":{"type":"boolean","description":"Return personal email addresses such as tcook1960@gmail.com."}},"description":"Types of emails Wiza may return for list-style enrichment.","additionalProperties":false},"enrichment_level":{"type":"string"}},"additionalProperties":{}},"type":{"type":"string","const":"list"},"status":{"type":"object","properties":{"code":{"type":"number"},"message":{"type":"string"}},"additionalProperties":{}},"billing":{"type":"object","required":["apiCredits","pricePerCreditUsdcMicro","settledUsdcMicro"],"properties":{"apiCredits":{"type":"number","description":"Wiza API credits found in the upstream response and used for metered settlement."},"settledUsdcMicro":{"type":"string","description":"Actual metered MPP settlement amount in USDC micro-units."},"pricePerCreditUsdcMicro":{"type":"string","description":"Configured USDC micro-units charged per Wiza API credit."}},"additionalProperties":false}},"additionalProperties":{}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"dynamic","summary":"$0.5/call (dynamic — varies by input)","primary":{"kind":"dynamic","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"dynamic","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_oM9xj_aJzuC4NQlcJ5MxF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_RzvptZ5QjPbn4RyJ-ns0F","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Creates a prospect list of leads (companies and/or people) using Wiza's data platform, proxied through ZeroClick with pay-per-use billing.","exampleAgentPrompt":"Build me a prospect list of VP of Sales contacts at SaaS companies with 50-500 employees in the United States — I need this for a cold outreach campaign.","exampleUseCases":[{"title":"Cold outreach list for SDR team","prompt":"I need a list of 50 Head of Marketing contacts at e-commerce companies in North America with between 100 and 1000 employees — can you build that prospect list for me?"},{"title":"Recruiting pipeline for a niche role","prompt":"Find me a prospect list of senior data engineers who work at fintech companies in New York, so I can reach out about open positions at my firm."},{"title":"ABM target account contacts","prompt":"I have a list of 10 target companies for our account-based marketing push — can you pull the VP-level and C-suite contacts at each of those companies so we can start our outreach?"}],"resultDescription":"Returns a structured prospect list containing lead records with fields such as full name, job title, company name, company size, industry, location, and where available, verified email addresses and LinkedIn profile URLs.","failureModes":["Search filters too narrow returning zero results","Invalid or unsupported filter parameters returning a 400 error","Wiza upstream service unavailable causing a 502 or timeout","Insufficient account credit or payment failure blocking the request","Rate limit exceeded on the underlying Wiza API"],"whenToPreferThis":"Choose this endpoint when you need to programmatically generate B2B prospect lists without setting up a Wiza account or API key directly. It is best suited for agents doing autonomous outbound sales research, recruiting, or account-based marketing that require fresh, structured lead data with contact information on demand.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T03:25:39.405Z","isFirstParty":true,"canonicalSlug":"withzero-wiza-prospect-list-builder-e043d3b8"}