{"uid":"cap_kw2ar3TNkCxBu0UMAKsHY","slug":"local-business-category-counts-698c2378","name":"Local Business Category Counts","description":"Count how many Google businesses fall under each category within a radius of a coordinate, optionally filtered by category or name. Returns categories ranked by business count - for local market sizing, competitor-density analysis and site-selection research. No match → empty results.","url":"https://places.openverbs.com/v1/business-categories?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer","maximum":100,"minimum":1,"description":"Maximum category buckets. Defaults to 20."},"query":{"type":"string","maxLength":200,"minLength":1,"description":"Optional name text to restrict the aggregation."},"categories":{"type":"array","items":{"type":"string","maxLength":80,"minLength":1},"maxItems":10,"minItems":1,"description":"Optional Google business categories to restrict the aggregation, e.g. [\"restaurant\"]."},"locationCoordinate":{"type":"string","pattern":"^-?\\d{1,2}(\\.\\d+)?,-?\\d{1,3}(\\.\\d+)?,\\d{1,4}(\\.\\d+)?$","description":"\"lat,lng,radiusKm\", e.g. \"37.7749,-122.4194,10\". Use the geocode verb to turn a place name into coordinates."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","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.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_idT_wJwvcjFguXVekX7CW","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Aggregates and counts local businesses by category within a geographic radius, optionally filtered by name text or specific categories","exampleAgentPrompt":"Can you show me the top 15 business categories within 8km of 37.7749,-122.4194 in San Francisco, filtered to food-related businesses only?","exampleUseCases":[{"title":"Restaurant market saturation analysis","prompt":"I'm thinking of opening a new café in Austin — can you count the different food and drink business categories within 10km of 30.2672,-97.7431 and show me the top 20 so I can see how saturated the market is?"},{"title":"Neighborhood business diversity check","prompt":"What are the most common business categories within 3km of 40.7128,-74.0060 in lower Manhattan? Give me up to 25 category buckets so I can understand what kinds of businesses dominate that area."},{"title":"Competitor category density research","prompt":"How many gyms, yoga studios, and fitness businesses are there within 5km of 34.0522,-118.2437 in Los Angeles? Restrict the aggregation to fitness categories and show me up to 10 buckets."}],"resultDescription":"Returns a ranked list of business category buckets, each with a category name and the count of matching businesses found within the specified geographic radius. Results are sorted by count descending and limited to the requested number of buckets.","failureModes":["Invalid coordinate format (must match lat,lng,radiusKm pattern) returns a validation error","Radius or coordinate outside supported geographic bounds may return empty results","No businesses found matching the category or name filter returns an empty bucket list","limit out of range (must be 1–100) returns a schema validation error","categories array exceeding 10 items is rejected","query text exceeding 200 characters is rejected"],"whenToPreferThis":"Choose this endpoint when you need aggregate counts and distributions of business categories in a geographic area rather than individual business listings. It is ideal for market research, competitive density analysis, and neighborhood profiling. Prefer this over the full place-search endpoint when you want statistical summaries rather than individual business details, and over the Google Business Profile lookup when you need population-level insights rather than a single business record.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T18:59:06.250Z","isFirstParty":false,"canonicalSlug":"local-business-category-counts-698c2378"}