{"uid":"cap_AQcNHALXbYP8_jOwgKIO7","slug":"wiza-withzero-xyz-wiza-prospect-search-proof-only-91937be6","name":"Wiza Prospect Search (Proof-Only)","description":"Count matching Wiza prospects by title, seniority, role, current company, industry, location, company size, funding, revenue, LinkedIn slug, and other Wiza filters. Company-name aliases are normalized to Wiza job_company; domain-only company targeting is rejected because Wiza Prospect does not support it. Proof-only route: no payment; returned preview profiles consume Wiza API credits and belong on paid list/reveal routes.","url":"https://wiza.withzero.xyz/api/v1/prospects/search","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["filters"],"properties":{"size":{"type":"number","const":0,"description":"Count-only proof route: omit this field or set it to 0. Returned preview profiles consume Wiza API credits and must use a paid route."},"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":{}}},"additionalProperties":false},"responseSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"data":{"type":"object","properties":{"total":{"type":"number"},"profiles":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"additionalProperties":{}},"status":{"type":"object","properties":{"code":{"type":"number"},"message":{"type":"string"}},"additionalProperties":{}}},"additionalProperties":{}},"example":{"request":{"size":10,"filters":{"revenue":["$10M-$25M","$25M-$50M","$50M-$100M"],"job_role":["engineering"],"job_title_level":["Director"],"company_industry":[{"s":"i","v":"software"}],"company_location":[{"b":"city","v":"Austin, Texas, United States"}]}},"response":{"data":{"total":0,"profiles":[]},"status":{"code":200}}},"exampleRequest":{"size":10,"filters":{"revenue":["$10M-$25M","$25M-$50M","$50M-$100M"],"job_role":["engineering"],"job_title_level":["Director"],"company_industry":[{"s":"i","v":"software"}],"company_location":[{"b":"city","v":"Austin, Texas, United States"}]}},"tags":[],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"free_handshake","priceSource":"registry","requiresHandshake":true,"reviewCount":3,"rating":{"score":"1.00","successRate":"0.97","reviews":3,"stars":"5.0","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"free","summary":"free · handshake required","primary":null,"accepted":[]},"paymentMethods":[],"brandName":"wiza.withzero.xyz","brandSlug":"wiza-withzero-xyz-mpp","brandBaseUrl":"https://wiza.withzero.xyz","brandDocsUrl":null,"whatItDoes":"Search Wiza's prospect database by title, seniority, role, company, industry, location, funding, revenue, and more — returning a preview count and sample profiles without payment.","exampleAgentPrompt":"Search Wiza for prospects with the title 'Head of Engineering', seniority 'director', in the engineering role, at companies in the software industry with revenue between $10M and $100M located in Austin, Texas — show me up to 10 preview profiles.","exampleUseCases":[{"title":"Validate recruiting filters for engineers","prompt":"I want to find senior engineers in the Bay Area for our startup. Can you search Wiza for prospects with the title 'Staff Engineer' or 'Principal Engineer', seniority 'manager' or above, in the engineering role, at Series B or Series C funded companies — and show me how many match before I build a full list?"},{"title":"Check sales prospect availability by region","prompt":"We're expanding our sales team's territory in the Midwest. Search Wiza for prospects with the title 'VP of Sales' or 'Sales Director', seniority 'director' or 'VP', in the sales role, at mid-market companies with $50M to $500M revenue located in Chicago, Illinois — give me a preview count and sample profiles."},{"title":"Estimate marketing talent pool size","prompt":"We're hiring a marketing team for our Series A. Can you check Wiza for prospects with titles like 'Marketing Manager' or 'Senior Marketing Manager', seniority 'manager', in the marketing role, at SaaS and software companies in New York with $5M to $50M revenue — just show me how many are out there?"}],"resultDescription":"Returns a total count of matching prospects and up to 30 preview profiles including name, job title, company, and location. No credits are charged — this is a proof-only search to validate filter parameters before committing to a paid enrichment list.","failureModes":["Missing required 'filters' field returns a 400 validation error","Invalid enum values for job_role, revenue, or location type return schema validation errors","Overly broad filters may return very large total counts but still cap previews at 30","Empty filters object returns all prospects up to the size limit","Network or authentication errors return 5xx status codes","Size parameter exceeding 30 is rejected"],"whenToPreferThis":"Use this endpoint when you want to validate search filters and preview prospect counts before committing credits to a paid enrichment list. It's the right choice for exploring the Wiza database, testing filter combinations, and estimating list size — without any payment or credit consumption. Prefer this over the 'Create prospect list' endpoint when you're still iterating on filters.","instructions":"# Count matching prospects — free scoping node before a paid build.\n\n## Workflow\nPre-flight for the paid prospect-list builder: get a count before spending. Returns data.total only when size=0 (preview profiles cost credits and belong on the paid routes).\n- build the list: POST /api/v1/prospect-lists {list, filters} — reuse the same filters. Paid.\n- read results there via the free /lists/get and /lists/contacts routes.","reviewSummary":"Wiza Prospect Search accurately counts and previews matching leads using filters like job title, seniority, company name, industry, location, and funding — all before any enrichment spend. Company-name aliases are normalized automatically, and unsupported domain-only queries are rejected cleanly rather than returning bad results. All three reviews report perfect accuracy and reliability, making this a strong free planning step before committing to paid list or reveal routes.","reviewSummaryHighlights":["Accurate prospect counts and preview profiles returned without payment or enrichment spend","Supports batched multi-company + seniority filtering in a single call","Automatically normalizes company-name aliases and rejects unsupported domain-only queries"],"reviewSummaryConcerns":[],"reviewSummaryGeneratedAt":"2026-07-07T12:12:19.954Z","activationCount":557,"lastUsedAt":"2026-07-29T00:21:32.038Z","lastSuccessfullyRanAt":"2026-07-06T22:57:37.031Z","lastHealthCheckAt":"2026-09-14T19:02:02.182Z","isFirstParty":true}