# Vaaya Signalbase Company Search

> Vaaya Signalbase Company Search is a paid API for AI agents from vaaya.ai, paid per call via x402, $0.25/call, status unknown (last checked 2026-09-13).

Search and filter a database of company profiles by industry, headcount, location, founding year, categories, domain, or LinkedIn URL — returning structured firmographic records.

## Facts

- Endpoint: POST https://vaaya.ai/api/run/signalbase/companies
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vaaya-signalbase-company-search-a2783144
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_J7C9uOjQEUVIdHJzt9Zsa

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 vaaya-signalbase-company-search-a2783144 -d '<json body>'
```

Example prompt: Find me up to 50 SaaS companies headquartered in Germany with between 100 and 500 employees that were founded after 2010 — I want their industry, headcount, and LinkedIn URLs so I can enrich them with signals later.

## When to prefer this

Use this endpoint when you need to discover or resolve company firmographic profiles without tying the search to a specific behavioral signal (like hiring or funding). It is the right first step before calling signal-enriched endpoints — use it to find, filter, and confirm which companies you want to track. Prefer it over people-search or hiring-signal endpoints when the primary goal is company-level discovery by attributes like size, geography, industry, or founding era.

## Known failure modes

- Empty results if filters are too narrow or no companies match
- Limit exceeded if `limit` is set above 100
- Invalid filter values (e.g. malformed domain or LinkedIn URL) returning 400-level errors
- Payment failure via x402 protocol if USDC balance is insufficient
- Rate limiting or quota errors if many calls are made in rapid succession

## How this service works

Signalbase — COMPANY search independent of any signal: profiles with industry, headcount, location, founded year, categories. Filters: `search` (free text), `domain`/`linkedin_url` (exact lookup), `industry`/`categories` (comma-separated), `countries`, `employee_count_min`/`max`, `founded_year_min`/`max`. `limit` ≤100 — flat price per call. Use to resolve/browse companies before pulling their signals.

## Output

A paginated list of company profile objects, each containing firmographic fields such as company name, domain, LinkedIn URL, industry, employee count, founded year, location/countries, and categories. Optionally includes a total result count if the `count` flag is set to true.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "$schema": "http://json-schema.org/draft-07/schema#",
     "properties": {
      "page": {
       "type": "integer",
       "minimum": 1
      },
      "count": {
       "enum": [
        "true",
        "false"
       ],
       "type": "string"
      },
      "limit": {
       "type": "integer",
       "maximum": 100,
       "minimum": 1
      },
      "dateTo": {
       "type": "string"
      },
      "domain": {
       "type": "string"
      },
      "search": {
       "type": "string"
      },
      "sort_by": {
       "type": "string"
      },
      "dateFrom": {
       "type": "string"
      },
      "industry": {
       "type": "string"
      },
      "countries": {
       "type": "string"
      },
      "categories": {
       "type": "string"
      },
      "sort_order": {
       "enum": [
        "asc",
        "desc"
       ],
       "type": "string"
      },
      "date_preset": {
       "type": "string"
      },
      "linkedin_url": {
       "type": "string"
      },
      "subcategories": {
       "type": "string"
      },
      "founded_year_max": {
       "type": "integer"
      },
      "founded_year_min": {
       "type": "integer"
      },
      "exclude_countries": {
       "type": "string"
      },
      "employee_count_max": {
       "type": "integer",
       "minimum": 0
      },
      "employee_count_min": {
       "type": "integer",
       "minimum": 0
      }
     },
     "additionalProperties": true
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

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