{"uid":"cap_3SiyqxqdXrlIGJcVk_sLi","slug":"google-maps-business-search-async-71446f50","name":"Google Maps Business Search (Async)","description":"Start a search on Google Maps. Searches businesses by query across specified areas. Charges 3 credits ($0.06) per business found. Async: poll with /google-maps-search/poll.","url":"https://x402.orthogonal.com/fiber/v1/google-maps-search/start?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"name":{"type":"string","description":"Optional project name for reference"},"query":{"type":"string","description":"Search query for Google Maps (e.g. 'dominos pizza'). Do not include location."},"strategy":{"type":"object","description":"Search strategy. Use {\"strategy\":\"whole-usa\"} or {\"strategy\":\"specific-areas\",\"unionAll\":[...]}"},"maxResults":{"type":"integer","description":"Max results to return (default 100, max 10000)"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"6","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":"$6/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"6","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"6","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_uq0zrY-kBtDolXSMjoGRd","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"6","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Starts an async Google Maps business search by query across the USA or specific areas, returning up to 10,000 business results polled via a separate endpoint.","exampleAgentPrompt":"Search Google Maps for all 'urgent care clinics' across the whole USA and return up to 500 results — I want to build a nationwide directory.","exampleUseCases":[{"title":"Nationwide franchise location mapping","prompt":"Find all 'Chick-fil-A' locations across the entire USA on Google Maps, up to 2000 results, so I can map their national footprint."},{"title":"Regional competitor discovery","prompt":"Search Google Maps for 'CrossFit gym' in Los Angeles, Chicago, and Houston — give me up to 300 results so I can analyze the competitive landscape in those cities."},{"title":"Local business lead generation","prompt":"I need a list of all 'roofing contractors' in Texas from Google Maps, max 1000 results, for a sales prospecting campaign."}],"resultDescription":"Returns a job/poll ID that can be used with the /google-maps-search/poll endpoint to retrieve the async results. Final results include business listings with names, addresses, and place details scraped from Google Maps, up to the requested maxResults count.","failureModes":["Invalid or missing query returns 400 error","Unsupported strategy object format causes validation failure","maxResults exceeding 10000 is rejected","Insufficient USDC balance triggers payment failure","Poll endpoint must be called separately — this endpoint only starts the job","Search returning zero results if query is too specific or area has no matches"],"whenToPreferThis":"Use this endpoint when you need to bulk-scrape Google Maps business listings for a specific query across wide geographic areas (whole USA or multiple cities). Prefer this over real-time search APIs when you need large result sets (up to 10,000) and can tolerate async polling. Ideal for lead generation, competitive analysis, franchise mapping, or building business directories.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-17T06:49:51.133Z","isFirstParty":false,"canonicalSlug":"google-maps-business-search-async-71446f50"}