# HivemindOS Nearby Leads Finder

> HivemindOS Nearby Leads Finder is a paid API for AI agents from api.hivemindos.app, paid per call via x402, $0.07/call, status unknown (last checked 2026-10-11).

Lists local businesses of specified types within a given radius around a latitude/longitude coordinate, returning lead data for outreach or prospecting.

## Facts

- Endpoint: POST https://api.hivemindos.app/v1/x402/leadgen-data/leads.nearby?utm_source=zero.xyz
- Price: $0.07/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hivemindos-nearby-leads-finder-b89a5e29
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_my0zYmfcHflDr0HSNZSOI

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-nearby-leads-finder-b89a5e29 -d '<json body>'
```

Example prompt: Find me all gyms and yoga studios within 3 kilometers of latitude 40.7128, longitude -74.0060 — I need a list of leads to reach out to.

## When to prefer this

Choose this endpoint when you have a specific geographic coordinate and want to discover businesses of particular types within a defined radius — ideal for lead generation, territory mapping, or competitive analysis tied to a precise location. Prefer this over the text-search sibling endpoint when you have exact coordinates rather than a city name or keyword query.

## Known failure modes

- Invalid latitude or longitude values outside allowed ranges return a validation error
- Unsupported or unrecognized business type strings may return empty results
- Radius below 100m or above 50,000m triggers a validation error
- More than 10 included types in the array exceeds the schema limit
- Payment failure in the x402 flow prevents the call from completing
- No businesses found in sparse or rural areas returns an empty list

## How this service works

Find leads near a point: lists businesses of given types around a latitude and longitude. $0.07 this call, in USDC on Base; you pay only if it succeeds. HivemindOS SuperAgent API.

## Output

Returns a list of businesses matching the requested types near the specified coordinates, including business details such as names, addresses, and type classifications, suitable for use as sales leads or market intelligence.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "latitude": {
   "type": "number",
   "maximum": 90,
   "minimum": -90
  },
  "companyId": {
   "type": "string"
  },
  "longitude": {
   "type": "number",
   "maximum": 180,
   "minimum": -180
  },
  "radiusMeters": {
   "type": "number",
   "default": 5000,
   "maximum": 50000,
   "minimum": 100
  },
  "includedTypes": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "maxItems": 10
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hivemindos-nearby-leads-finder-b89a5e29/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)