{"uid":"cap_tU9EOFDu8XJSU2s3dv2dJ","slug":"local-business-directory-search-1b18b485","name":"Local Business Directory Search","description":"Search Google's local business directory within a radius of a coordinate, filtered by category and/or a name query. Returns ranked businesses with name, category, star rating and review count, address, phone, website domain, place_id/CID and coordinates. Richer than a SERP local pack. No match → empty results.","url":"https://places.openverbs.com/v1/business-search","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","properties":{"limit":{"type":"integer","maximum":100,"minimum":1,"description":"Maximum results. Defaults to 10."},"query":{"type":"string","maxLength":200,"minLength":1,"description":"Name text to match, e.g. \"coffee\". Provide categories and/or query."},"categories":{"type":"array","items":{"type":"string","maxLength":80,"minLength":1},"maxItems":10,"minItems":1,"description":"Google business categories to match, e.g. [\"coffee_shop\"]. Provide categories and/or query."},"locationCoordinate":{"type":"string","pattern":"^-?\\d{1,2}(\\.\\d+)?,-?\\d{1,3}(\\.\\d+)?,\\d{1,4}(\\.\\d+)?$","description":"\"lat,lng,radiusKm\", e.g. \"37.7749,-122.4194,10\". Use the geocode verb to turn a place name into coordinates."}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"count":1,"total":128,"results":[{"cid":"1958883682639164205","name":"Bello Coffee & Tea","rank":1,"phone":"+1 415-585-3457","domain":"bello.coffee","rating":4.4,"address":"2885 Diamond St, San Francisco, CA 94131","claimed":true,"placeId":"ChIJ0aQ0Vl2AhYARabc123","website":"https://bello.coffee","category":"Coffee shop","latitude":37.7421,"longitude":-122.4335,"reviewsCount":326}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_fUh7HG69DUO8b0iXijOMa","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search Google Business profiles by name, category, and location radius, returning ratings, hours, coordinates, and contact details.","exampleAgentPrompt":"Find me up to 10 coffee shops within 5km of 37.7749,-122.4194 on Google Business — I need their names, ratings, phone numbers, and addresses.","exampleUseCases":[{"title":"Nearby restaurant discovery","prompt":"Search for Italian restaurants within 3km of 40.7580,-73.9855 and give me the top 5 results with their ratings, addresses, and phone numbers."},{"title":"Business profile lookup by name","prompt":"Look up the Google Business profile for 'Bello Coffee & Tea' in San Francisco — I need their rating, website, place ID, and exact coordinates."},{"title":"Category-based competitor research","prompt":"Find all yoga studios within 10km of 34.0522,-118.2437 — return up to 20 results with their ratings, review counts, and websites so I can compare them."}],"resultDescription":"Returns a paginated list of matching business profiles, each including the business name, CID, place_id, address, latitude/longitude, phone number, website domain, Google rating, review count, primary category, and whether the listing is claimed. Also includes total count of matches and result rank.","failureModes":["Missing both query and categories — at least one must be provided","Invalid locationCoordinate format — must be 'lat,lng,radiusKm' with valid numeric ranges","No results found for the given query/location combination — returns empty results array","Rate limiting or payment failure via x402 protocol — results in 402 Payment Required","Query string too long (over 200 chars) or too many categories (over 10) — schema validation error"],"whenToPreferThis":"Choose this endpoint when you need structured Google Business data (ratings, coordinates, categories, place_id) for local businesses searched by name or category within a geographic radius. Prefer this over generic web search when you need machine-readable business profiles with consistent fields. Ideal for building local business finders, competitor research tools, or enriching location-based datasets with authoritative Google Business metadata.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:30:29.430Z","isFirstParty":false}