# Wiza Prospect Search (Proof-Only)

> Wiza Prospect Search (Proof-Only) is a free API for AI agents from wiza.withzero.xyz, free · handshake required, status unknown (last checked 2026-09-14, last successful call 2026-07-06).

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.

## Facts

- Endpoint: POST https://wiza.withzero.xyz/api/v1/prospects/search
- Price: free · handshake required
- Status: unknown
- Last checked: 2026-09-14
- Last successful call: 2026-07-06
- Success rate: 97% of calls made through Zero
- Rating: 5.0 / 5 from 3 reviews
- Activations on Zero: 557
- Provider: wiza.withzero.xyz
- Website: https://wiza.withzero.xyz
- Canonical page: https://www.zero.xyz/c/wiza-withzero-xyz-wiza-prospect-search-proof-only-91937be6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AQcNHALXbYP8_jOwgKIO7

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability wiza-withzero-xyz-wiza-prospect-search-proof-only-91937be6 -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Example request

```json
{
 "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"
   }
  ]
 }
}
```

## Request schema (JSON Schema)

```json
{
 "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": {
       "
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "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": {}
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/wiza-withzero-xyz-wiza-prospect-search-proof-only-91937be6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from wiza.withzero.xyz](https://www.zero.xyz/host/wiza.withzero.xyz/llms.txt)