Api Endpoint

HivemindOS

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

Open interactive test console

Offering

Provider
api.hivemindos.app
Method
POST
Offering type
Api Endpoint
Transport type
http
Category
Business And Commerce
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://api.hivemindos.app/v1/x402/leadgen-data/leads.nearby
MIME type
Not provided
First seen
2026-10-16T01:50:38.788Z
Last seen
Tags
leads, sales, local-business, places

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.07 USDC
Atomic price: 70000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "70000",
    "payTo": "0xbD62F8DCB52E21CA5BDf20ba173488Da101eBCf0"
  }
]

Observed health

Status
Healthy
Latest latency
350 ms
Average latency
812 ms
HTTP status
204
Last checked
Reachability
100% over 14 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "body": {
      "properties": {
        "companyId": {
          "description": "Any name for the business you are prospecting for.",
          "type": "string"
        },
        "includedTypes": {
          "description": "Place types, such as plumber or cafe.",
          "items": {
            "type": "string"
          },
          "maxItems": 10,
          "type": "array"
        },
        "latitude": {
          "description": "Centre latitude.",
          "maximum": 90,
          "minimum": -90,
          "type": "number"
        },
        "longitude": {
          "description": "Centre longitude.",
          "maximum": 180,
          "minimum": -180,
          "type": "number"
        },
        "radiusMeters": {
          "default": 5000,
          "description": "Search radius in metres.",
          "maximum": 50000,
          "minimum": 100,
          "type": "number"
        }
      },
      "required": [
        "companyId",
        "latitude",
        "longitude"
      ],
      "type": "object"
    },
    "bodyType": {
      "enum": [
        "json",
        "form-data",
        "text"
      ],
      "type": "string"
    },
    "method": {
      "enum": [
        "POST"
      ],
      "type": "string"
    },
    "type": {
      "const": "http",
      "type": "string"
    }
  },
  "required": [
    "type",
    "method",
    "bodyType",
    "body"
  ],
  "type": "object"
}

Output schema

{
  "properties": {
    "example": {
      "properties": {
        "chargedCredits": {
          "description": "Agent Credits the service charged (500 = $1).",
          "type": "number"
        },
        "followUp": {
          "description": "apiKey holding the credits the call did not use, or null when none are left.",
          "properties": {
            "apiKey": {
              "type": "string"
            },
            "keyId": {
              "type": [
                "string",
                "null"
              ]
            },
            "remainingCredits": {
              "type": "number"
            },
            "use": {
              "type": "string"
            }
          },
          "type": [
            "object",
            "null"
          ]
        },
        "ok": {
          "description": "true when the call worked; a failed call is never charged.",
          "type": "boolean"
        },
        "operationId": {
          "type": "string"
        },
        "result": {
          "description": "Businesses near the point, each with a place id, name, address, rating and category."
        },
        "serviceId": {
          "type": "string"
        },
        "status": {
          "description": "The service's own HTTP status.",
          "type": "integer"
        },
        "x402": {
          "description": "The payment: settled only after the call worked.",
          "properties": {
            "charged": {
              "type": "boolean"
            },
            "network": {
              "type": [
                "string",
                "null"
              ]
            },
            "payer": {
              "type": [
                "string",
                "null"
              ]
            },
            "priceUsd": {
              "type": "number"
            },
            "receiptId": {
              "type": "string"
            },
            "transaction": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "type": "object"
        }
      },
      "required": [
        "ok",
        "x402"
      ],
      "type": "object"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}