# Bytemine Contact Search

> Bytemine Contact Search is a paid API for AI agents from agents.bytemine.ai, paid per call via MPP, $0.2/call, status healthy (last checked 2026-09-14, last successful call 2026-09-01).

Search a database of 135M+ professionals by title, company, location, skills, seniority, and many other filters to find matching contact records

## Facts

- Endpoint: POST https://agents.bytemine.ai/functions/v1/api-gateway/contacts/search
- Price: $0.2/call
- Payment: MPP
- Status: healthy
- Last checked: 2026-09-14
- Last successful call: 2026-09-01
- Success rate: 94% of calls made through Zero
- Rating: 3.7 / 5 from 1 review
- Activations on Zero: 16
- Provider: agents.bytemine.ai
- Website: https://agents.bytemine.ai
- Canonical page: https://www.zero.xyz/c/agents-bytemine-ai-bytemine-contact-search-104097ba
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_r7wRW6u5zGuItfiC8Wxk2

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 agents-bytemine-ai-bytemine-contact-search-104097ba -d '<json body>'
```

Example prompt: Find me VP-level and above contacts in the Sales or Marketing department at SaaS companies headquartered in New York — I need their names, titles, and companies, give me the first page of results.

## When to prefer this

Use this endpoint when you need to discover and build lists of professional contacts matching specific criteria such as title, seniority, company, industry, location, or skills. It is ideal for sales prospecting, recruiting, and account-based marketing targeting. Prefer this over company search when the primary target is individual people rather than organizations.

## Known failure modes

- No results returned if filters are too restrictive or no contacts match
- Invalid filter values (e.g. unsupported seniority or department names) may cause errors or empty results
- Pagination cursor mismatch if used out of sequence
- Authentication or payment errors if credentials are missing or insufficient balance
- Rate limiting or quota errors under heavy usage

## 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

A paginated list of professional contact records matching the search criteria, each including fields such as name, job title, company, seniority, department, location, skills, and other profile attributes. Also includes a pagination cursor for fetching subsequent pages. Results are billed per record returned.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "age": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "array",
     "items": {
      "type": "string"
     }
    },
    {
     "type": "array",
     "items": {
      "type": "object",
      "required": [
       "value",
       "included"
      ],
      "properties": {
       "value": {
        "type": "string"
       },
       "included": {
        "type": "boolean"
       }
      }
     }
    }
   ],
   "description": "Age range filter, for example 25-34."
  },
  "page": {
   "type": "integer",
   "description": "Page number, 0 indexed. Default 0."
  },
  "urls": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "array",
     "items": {
      "type": "string"
     }
    },
    {
     "type": "array",
     "items": {
      "type": "object",
      "required": [
       "value",
       "included"
      ],
      "properties": {
       "value": {
        "type": "string"
       },
       "included": {
        "type": "boolean"
       }
      }
     }
    }
   ],
   "description": "Company website or domain filter."
  },
  "after": {
   "type": "string",
   "description": "Pagination cursor for the next page."
  },
  "cities": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "array",
     "items": {
      "type": "string"
     }
    },
    {
     "type": "array",
     "items": {
      "type": "object",
      "required": [
       "value",
       "included"
      ],
      "properties": {
       "value": {
        "type": "string"
       },
       "included": {
        "type": "boolean"
       }
      }
     }
    }
   ],
   "description": "City filter."
  },
  "gender": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "array",
     "items": {
      "type": "string"
     }
    },
    {
     "type": "array",
     "items": {
      "type": "object",
      "required": [
       "value",
       "included"
      ],
      "properties": {
       "value": {
        "type": "string"
       },
       "included": {
        "type": "boolean"
       }
      }
     }
    }
   ],
   "description": "Gender filter. Options: Male, Female."
  },
  "skills": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "array",
     "items": {
      "type": "string"
     }
    },
    {
     "type": "array",
     "items": {
      "type": "object",
      "required": [
       "value",
       "included"
      ],
      "properties": {
       "value": {
        
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-bytemine-ai-bytemine-contact-search-104097ba/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)