Search businesses
search_businessesSearch the 1network directory of US local businesses by category, place, rating, open now and "accepts requests". Free. Returns at most 25 businesses a page with their public phone and website, labelled sponsored or featured when paid. Use accepts_requests true to find the businesses that request_quotes can reach.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_businesses"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Words in the business name. | |
| lat | No | Latitude, with lng and radius_miles to search around a point. | |
| lng | No | Longitude. | |
| zip | No | 5-digit ZIP code. | |
| city | No | City name (use with state). | |
| limit | No | How many results (1 to 25, default 10; 10 a page without an API key). | |
| state | No | 2-letter US state code. | |
| cursor | No | next_cursor from the previous page. | |
| category | No | Category slug or name from list_categories, for example "plumbers". | |
| open_now | No | Only businesses open right now. | |
| directory | No | Limit to one industry directory's categories. One of: auto, childcare, cleaning, dentists, electricians, fitness, hvac, lawn, lawyers, med-spa, pets, plumbers, remodelers, restoration, salons, senior-care, tax-finance, therapists, weddings, wellness. | |
| min_rating | No | Only businesses rated at least this many stars. | |
| radius_miles | No | Search radius in miles around lat/lng or the ZIP code. | |
| accepts_requests | No | true: only businesses that accept quote requests from AI assistants (the ones request_quotes can reach). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| shown | Yes | ||
| filters | Yes | ||
| businesses | Yes | At most 25 businesses. Paid placement is labelled with sponsored and featured. | |
| next_cursor | No | ||
| accepting_requests | Yes | How many of the shown businesses accept AI requests. |