# HivemindOS Lead Enrichment

> HivemindOS Lead Enrichment is a paid API for AI agents from api.hivemindos.app, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-12).

Enriches up to 10 place IDs (from discover or nearby searches) with phone numbers, websites, business hours, and ratings.

## Facts

- Endpoint: POST https://api.hivemindos.app/v1/x402/leadgen-data/leads.enrich?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hivemindos-lead-enrichment-39b552d6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QbffeKrRYzoDmhNKBY0mf

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 hivemindos-lead-enrichment-39b552d6 -d '<json body>'
```

Example prompt: I found 8 plumbing businesses nearby — can you enrich those place IDs with their phone numbers, websites, hours, and ratings so I can start reaching out?

## When to prefer this

Use this endpoint immediately after discovering leads via HivemindOS discover or nearby endpoints, when you need to hydrate bare place IDs with actionable contact details (phone, website, hours, ratings) before outreach or CRM ingestion. Prefer this over a full re-search when you already have place IDs and just need enrichment data.

## Known failure modes

- Invalid or unrecognized place IDs return empty or partial results
- Exceeding 10 place IDs per call returns a validation error
- Payment failure in USDC on Base results in no data returned and no charge
- Some places may have incomplete data if the underlying source lacks coverage
- Missing companyId may cause attribution errors in multi-tenant setups

## How this service works

Enrich lead details: adds phone, website, hours and ratings to up to 10 places found by discover or nearby. $0.05 this call, in USDC on Base; you pay only if it succeeds. HivemindOS SuperAgent API.

## Output

Returns enriched lead records for each submitted place ID, including phone number, website URL, business hours, and user ratings — ready for sales outreach or CRM import.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "placeIds": {
   "type": "array",
   "items": {
    "type": "string",
    "pattern": "^[A-Za-z0-9_-]{10,}$"
   },
   "maxItems": 10,
   "minItems": 1
  },
  "companyId": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hivemindos-lead-enrichment-39b552d6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.hivemindos.app](https://www.zero.xyz/host/api.hivemindos.app/llms.txt)