Skip to content
onelayer.
All tools

Tool detail

search

Finds local businesses by category or keyword and location, with filters for rating, review count, chain status and open status.

Categories: Maps places

Use when

  • find local businesses in a category, such as HVAC contractor, near a location
  • filter local business results by minimum rating or review count

Not for

  • not general web search -- local business listings only

Inputs

POST JSON body: location: string[] (required); optional category[], keywords[], limit, min_rating, min_review_count, has_domain, is_chain, operating_status

Admitted input schema

{
  "type": "object",
  "properties": {
    "category": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 0,
        "maxLength": 4096
      },
      "minItems": 0,
      "maxItems": 100,
      "description": "Business categories (e.g. \"hvac contractor\", \"dental practice\")"
    },
    "has_domain": {
      "type": "boolean",
      "description": "true = only rows with a resolvable website domain"
    },
    "is_chain": {
      "type": "boolean",
      "description": "true = only chains, false = exclude detected chains"
    },
    "keywords": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 0,
        "maxLength": 4096
      },
      "minItems": 0,
      "maxItems": 100,
      "description": "Free-text keywords (alternative to category)"
    },
    "limit": {
      "type": "number",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Max results (1-500, default 100)"
    },
    "location": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 0,
        "maxLength": 4096
      },
      "minItems": 0,
      "maxItems": 100,
      "description": "Cities, neighborhoods, or \"City, ST\" strings"
    },
    "min_rating": {
      "type": "number",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Minimum star rating (0-5)"
    },
    "min_review_count": {
      "type": "number",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Minimum review count"
    },
    "operating_status": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "enum": [
        "open",
        "any"
      ],
      "description": "Default \"open\" drops closed businesses"
    }
  },
  "required": [
    "location"
  ],
  "additionalProperties": false
}

Endpoint

Method
POST
URL
https://win.oneshotagent.com/v1/tools/local/search

Payment

Protocol
x402
Listed price
0.01 USDC per call on Base
Payment method
exact
Network
eip155:8453
Asset
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.

Source

Record
POST https://win.oneshotagent.com/v1/tools/local/search
Retrieved
2026-09-30T20:37:07.382Z
Catalog file SHA-256
6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built
2026-09-30T22:31:58.034Z