{"uid":"cap_nVIsBqLAX43r8-r5BDTzJ","slug":"places-openverbs-com-place-details-4e2681cf","name":"places.openverbs.com Place Details","description":"Look up a business's full Google Business Profile by name and location. Returns name, category, star rating and review count, address, phone, website, opening hours by day, Google place_id and CID, coordinates and claimed status. For place enrichment, store-hours and business lookups. Unknown business returns found=false.","url":"https://places.openverbs.com/v1/place-details","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":["name"],"properties":{"name":{"type":"string","maxLength":300,"minLength":1,"description":"Business name (optionally with city), e.g. \"Blue Bottle Coffee San Francisco\"."},"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":{"cid":"1958883682639164205","name":"Blue Bottle Coffee","found":true,"hours":{"monday":[{"open":"07:00","close":"18:00"}],"sunday":[{"open":"08:00","close":"14:00"}]},"phone":"+1 510-661-3510","domain":"bluebottlecoffee.com","rating":4.4,"source":"dataforseo","address":"115 Sansome St, San Francisco, CA 94104","claimed":true,"placeId":"ChIJ-wU5Vl2AhYARLW9y0objABs","website":"https://bluebottlecoffee.com","category":"Coffee shop","latitude":37.79036,"longitude":-122.40145,"categories":["Cafe","Espresso bar"],"reviewsCount":1294}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_V413bMaIgMm-ylF_oTyUp","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Look up a business's full profile — rating, hours, categories, place_id, and coordinates — by name using Google Business data.","exampleAgentPrompt":"Can you pull up the full Google Business profile for Blue Bottle Coffee in San Francisco — I need their place ID, current hours, phone number, rating, and coordinates.","exampleUseCases":[{"title":"Verify restaurant hours before booking","prompt":"What are the current opening hours and phone number for Nobu Restaurant in New York? I want to make sure they're open on Monday before I plan a visit."},{"title":"Enrich CRM with business coordinates","prompt":"I have a business called 'Sweetgreen' in Los Angeles — can you get me their latitude, longitude, Google place ID, and website so I can add them to our location database?"},{"title":"Check competitor rating and reviews","prompt":"Look up the Google Business profile for Starbucks Reserve Roastery in Seattle — I need their rating, total review count, and what categories Google lists them under."}],"resultDescription":"Returns a JSON object with the business's name, Google place_id, cid, full address, phone number, website domain, rating, review count, claimed status, operating hours by day of week, latitude, longitude, primary category, and additional categories. Includes a 'found' boolean indicating whether the business was successfully located.","failureModes":["Business not found in Google Business data returns found:false with empty profile fields","Ambiguous business name without location may resolve to wrong location","Invalid or unsupported language code returns validation error","Name too long (>300 chars) or too short (<1 char) returns schema validation error","Network or upstream DataForSEO outage may cause timeout or 5xx error","Payment failure via x402 returns 402 with payment details required"],"whenToPreferThis":"Use this endpoint when you need structured Google Business profile data for a specific named business — including place_id, hours, coordinates, rating, and contact info — and you know the business name. Prefer this over a general search endpoint when you have a specific business in mind rather than browsing a category. Best for enriching CRM records, validating business listings, or resolving business names to Google place IDs programmatically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T13:01:59.516Z","isFirstParty":false}