{"uid":"cap_W5ilm4x8S4xKQylmi0_xi","slug":"openverbs-local-place-search-75c7a38a","name":"OpenVerbs Local Place Search","description":"Live Google local-finder (map places) results for a query, localised by location and language. Returns ranked places with title, address, website domain, phone, rating and review count.","url":"https://search.openverbs.com/v1/local","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","required":["q"],"properties":{"q":{"type":"string","maxLength":700,"minLength":1,"description":"Search query."},"limit":{"type":"integer","maximum":100,"minimum":1,"description":"Depth / maximum results. Defaults to 10."},"language":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"Language code (2-letter). Defaults to en."},"location":{"type":"string","maxLength":120,"minLength":2,"description":"Location name, e.g. \"United States\" or \"London,England,United Kingdom\". Defaults to United States."}},"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":{"total":20,"results":[{"cid":"12345678901234567890","url":"https://bluebottlecoffee.com","rank":1,"phone":"+1 510-653-3394","title":"Blue Bottle Coffee","domain":"bluebottlecoffee.com","rating":4.5,"reviews":1287,"description":"Coffee shop"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_RHGrzhjPJctqFCf2FSkAu","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns live Google local-finder (map places) results for a search query, localised by location and language, including ranked place names, addresses, websites, phone numbers, ratings, and review counts.","exampleAgentPrompt":"Find me the top 10 Italian restaurants in London, England, United Kingdom — I need their names, addresses, phone numbers, and ratings.","exampleUseCases":[{"title":"Local competitor research for a business","prompt":"Search for all yoga studios in Austin, Texas and give me their names, websites, phone numbers, and star ratings — show me up to 20 results."},{"title":"Finding a local service provider while traveling","prompt":"I need to find urgent care clinics in Chicago, Illinois — give me the top 5 results with their addresses and phone numbers."},{"title":"Building a local business directory","prompt":"Look up the top 15 plumbers in Manchester, England, United Kingdom and return their names, ratings, review counts, and website domains in English."}],"resultDescription":"A ranked list of local places matching the query, each containing: place title, address, website domain, phone number, star rating, and review count — all sourced from live Google local-finder results and ordered by relevance/ranking.","failureModes":["No results found for the query and location combination","Invalid or unsupported language code causes fallback to default","Location string not recognized by the underlying search engine, returning unintended results","Query string too long (over 700 characters) triggers validation error","Payment not processed (x402 protocol failure) resulting in 402 response","Rate limiting or quota exhaustion on the underlying Google data source"],"whenToPreferThis":"Choose this endpoint when you need live, ranked local business/place data with rich details (phone, rating, address, website) for a specific geographic area and language. Ideal over static business databases when freshness and Google's ranking signal matter. Prefer over generic web search when structured place data fields (phone, rating, review count) are required rather than plain text snippets.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T13:01:59.514Z","isFirstParty":false}