# Drillr Company Search

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

Search and retrieve company records by name or other identifying details from the Drillr database.

## Facts

- Endpoint: POST https://gateway.drillr.ai/api/x402/data/company_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/drillr-company-search-8e82840c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ThwIB0mpQKT4k_Onn_CI6

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 drillr-company-search-8e82840c -d '<json body>'
```

Example prompt: Search Drillr for company records on 'Acme Corp' — I want to see whatever details come back about them.

## When to prefer this

Use this endpoint when you need to look up or retrieve company records by name or partial details from the Drillr dataset. Prefer this over generic web search when structured, database-style company records are needed, or when doing programmatic B2B data enrichment at low per-query cost.

## Known failure modes

- No matching company records found for the given query
- Ambiguous query returning too many or irrelevant results
- Query string is empty or malformed
- Service temporarily unavailable or rate-limited
- Payment of $0.01 USDC not processed or rejected by x402 protocol

## How this service works

Natural-language company discovery across US, Japan, Hong Kong, and China A-shares

## Output

Returns one or more company records matching the search query, including company name and associated details such as industry, location, or other identifying business information stored in the Drillr database.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "query": {
   "type": "string",
   "minLength": 1
  },
  "market": {
   "anyOf": [
    {
     "enum": [
      "us",
      "jp",
      "hk",
      "cn",
      "kr"
     ],
     "type": "string"
    },
    {
     "type": "array",
     "items": {
      "enum": [
       "us",
       "jp",
       "hk",
       "cn",
       "kr"
      ],
      "type": "string"
     },
     "maxItems": 5
    }
   ],
   "description": "One lowercase market or a market list from 'us' | 'jp' | 'hk' | 'cn' | 'kr'. Omit or pass [] for all five; list order does not set priority."
  }
 }
}
```

## More

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