Index onlineMerchant portal
Api Endpoint

HivemindOS

Find local business leads: searches local businesses by text, e.g. plumbers in a city, with up to 20 results. Use when an agent is building a prospect list of local businesses by category and place. $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.discover
MIME type
Not provided
First seen
2026-10-16T01:50:45.949Z
Last seen
Tags
leads, sales, local-business, places

Website

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
328 ms
Average latency
676 ms
HTTP status
204
Last checked
Reachability
100% over 15 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"
        },
        "latitude": {
          "description": "Centre latitude.",
          "maximum": 90,
          "minimum": -90,
          "type": "number"
        },
        "longitude": {
          "description": "Centre longitude.",
          "maximum": 180,
          "minimum": -180,
          "type": "number"
        },
        "maxResults": {
          "default": 20,
          "description": "How many businesses, up to 20.",
          "maximum": 20,
          "minimum": 1,
          "type": "integer"
        },
        "query": {
          "description": "What and where, e.g. plumbers in Sarasota FL.",
          "minLength": 1,
          "type": "string"
        },
        "radiusMeters": {
          "default": 5000,
          "description": "Search radius in metres.",
          "maximum": 50000,
          "minimum": 100,
          "type": "number"
        },
        "regionCode": {
          "description": "Optional two-letter country code to bias results.",
          "type": "string"
        }
      },
      "required": [
        "companyId",
        "query"
      ],
      "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": "Up to 20 businesses, 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"
}