{"uid":"cap_R3ldWgs3NFDzarCaWMIi8","slug":"pennyapi-local-business-places-search-b7cdbaa6","name":"PennyAPI Local Business & Places Search","description":"Real-time local business and places search for AI agents. Find restaurants, coffee shops, stores, services, and nearby businesses with structured names, addresses, coordinates, ratings, categories, phone numbers, and websites where available. Send query, optional num, country, and lang as URL parameters. Keyless x402 pay-per-call; no API key, account, or subscription required.","url":"https://pennyregwatch.com/web/places","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["query"],"properties":{"num":{"type":"integer","default":5,"maximum":10,"minimum":1},"lang":{"type":"string","maxLength":2,"minLength":2,"description":"Optional 2-letter language code"},"query":{"type":"string","description":"Local business or places search query"},"country":{"type":"string","maxLength":2,"minLength":2,"description":"Optional 2-letter country code"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"tool":"penny_places","count":1,"query":"coffee shops in Houston","places":[{"phone":"","title":"Example Coffee","rating":4.7,"address":"Houston, TX","website":"","category":"Coffee shop","latitude":29.76,"position":1,"longitude":-95.37,"rating_count":100}],"latency_ms":420,"retrieved_at":"2026-09-10T14:00:00+00:00"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_95Lwok6W-ucZpCeXKsYQj","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Real-time local business and places search returning structured results including names, addresses, coordinates, ratings, categories, phone numbers, and websites","exampleAgentPrompt":"Find me the top 5 Italian restaurants in Austin, Texas — I need their names, addresses, ratings, and phone numbers.","exampleUseCases":[{"title":"Restaurant discovery for dinner planning","prompt":"Find me 5 highly rated sushi restaurants in San Francisco and give me their addresses, ratings, and phone numbers so I can pick one to call."},{"title":"Travel research for local services","prompt":"I'm visiting Berlin next week — can you find 3 English-friendly coffee shops there? I'd like their addresses and websites if available."},{"title":"Competitor research for a local business","prompt":"Search for the top 8 yoga studios in Brooklyn, NY and return their names, ratings, categories, and contact info."}],"resultDescription":"Returns a JSON object with an array of up to 10 place results, each containing position rank, business title, address, latitude/longitude coordinates, category, rating score, rating count, phone number, and website URL where available, along with total count, query echo, retrieval timestamp, and latency in milliseconds.","failureModes":["Missing required 'query' parameter returns an error response","Invalid or unsupported country code may return no results or default to global search","Low-specificity queries may return irrelevant or geographically mismatched results","Insufficient USDC balance or x402 payment failure blocks the request","Very rare or niche business types in small regions may return 0 results","Rate limiting or upstream data provider outages may cause empty or delayed responses"],"whenToPreferThis":"Choose this endpoint when an AI agent needs structured, real-time local business data — especially names, addresses, coordinates, ratings, and contact info — without requiring API key setup or subscription management. Ideal for pay-per-call agentic workflows where keyless x402 micropayment access is preferred. Best suited for queries needing 1–10 results with optional country and language targeting.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T13:00:47.436Z","isFirstParty":false}