{"uid":"cap_ZBJ-OLDaLAjMeNzi1TNko","slug":"agentapi-places-search-eff30763","name":"AgentAPI Places Search","description":"Search for places/businesses by text query","url":"https://api.agentapihub.com/api/places/search","method":"POST","headers":{},"bodySchema":{"properties":{"input":{"required":["method"],"properties":{"method":{"enum":["POST"],"type":"string"}}}}},"responseSchema":{"places":[{"name":"Starbucks","phone":"+1 305-555-1234","rating":4.5,"address":"123 Main St"}]},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ghmgVhreT0VNoVHIrbqh6","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search for places and businesses by text query, returning name, address, phone, and rating data","exampleAgentPrompt":"Find me up to 10 Starbucks locations in Miami and give me their addresses, phone numbers, and ratings.","exampleUseCases":null,"resultDescription":"Returns a list of matching places, each with name, address, phone number, and star rating (e.g. 4.5).","failureModes":["Empty query string returns validation error","Limit value of 0 or negative may return empty or error response","No matching places returns empty places array","Overly broad query may return irrelevant results","Rate limiting or payment failure returns 402 error"],"whenToPreferThis":"Use this endpoint when you need to search for real-world businesses or places by keyword and need structured data (name, address, phone, rating) in return. Prefer this over geocoding APIs when the user wants to discover businesses rather than resolve a specific address.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:37:41.548Z","isFirstParty":false}