# Bytemine Contact Search

> Bytemine Contact Search is a paid API for AI agents from agents.bytemine.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Search a B2B prospect database by job title, seniority, department, industry, company, location, and other filters, returning masked contact results billed per record.

## Facts

- Endpoint: GET https://agents.bytemine.ai/functions/v1/api-gateway/contacts/search
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bytemine-contact-search-adab0455
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_j0M4EwNRYI2-pGHLlzla2

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 bytemine-contact-search-adab0455
```

Example prompt: Search Bytemine for up to 20 VP-level prospects in the SaaS industry located in San Francisco who work in product management — exclude anyone in HR.

## When to prefer this

Choose this endpoint when you need to discover or build lists of B2B prospects filtered by professional attributes like job title, seniority, department, industry, company, or location. It is ideal for sales prospecting, account-based marketing, and lead generation workflows where you want to query a structured contact database with flexible include/exclude filters. Prefer it over enrichment endpoints when you need to discover net-new contacts rather than enrich known ones.

## Known failure modes

- No results returned if filters are too narrow or no matching prospects exist
- Masked fields may limit usability of returned records for direct outreach
- Invalid filter values or malformed query parameters may result in an error or empty response
- Exceeding pageSize or sending unsupported filter combinations may cause unexpected behavior
- Rate limiting or payment failures via x402 protocol may prevent result retrieval

## How this service works

Search the prospect database by job title, seniority, department, industry, company, location, and more. Filters accept a plain string, an array of strings, or { value, included } objects for excludes. Returns masked results. Billed per result returned, up to pageSize.

## Output

Returns a paginated list of masked contact records matching the applied filters. Each record includes fields such as name (potentially masked), job title, seniority, department, company, industry, and location. Results are billed at $0.01 USDC per returned contact, up to the requested page size.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "contactId": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bytemine-contact-search-adab0455/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.bytemine.ai](https://www.zero.xyz/host/agents.bytemine.ai/llms.txt)
