{"uid":"cap_feOaOjnzaK0nF3VoulSh3","slug":"oneshot-agent-business-finder-e2df383e","name":"OneShot Agent Business Finder","description":"Local business discovery by category and location (restaurants, contractors, practices). Flat price per search.","url":"https://win.oneshotagent.com/v1/tools/find/business?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"number","description":"Max results (1-500, default 100)"},"category":{"type":"array","items":{"type":"string"},"description":"Business categories (e.g. \"hvac contractor\", \"dental practice\")"},"is_chain":{"type":"boolean","description":"true = only chains, false = exclude detected chains"},"keywords":{"type":"array","items":{"type":"string"},"description":"Free-text keywords (alternative to category)"},"location":{"type":"array","items":{"type":"string"},"description":"Cities, neighborhoods, or \"City, ST\" strings"},"has_domain":{"type":"boolean","description":"true = only rows with a resolvable website domain"},"min_rating":{"type":"number","description":"Minimum star rating (0-5)"},"min_review_count":{"type":"integer","description":"Minimum review count"},"operating_status":{"enum":["open","any"],"type":"string","description":"Default \"open\" drops closed businesses"}}},"responseSchema":{"type":"json","example":{"status":"processing","request_id":"uuid"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_yCno7ZB8dF1h8cC-sJoqJ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search and filter local businesses by category, location, rating, and other criteria to return a list of matching results","exampleAgentPrompt":"Find me up to 50 open HVAC contractors in Austin, TX with at least a 4-star rating and a minimum of 25 reviews — exclude chains and only include businesses that have a website.","exampleUseCases":[{"title":"Local contractor lead generation","prompt":"Find me up to 100 open dental practices in Chicago and Seattle with at least a 4-star rating and 10 or more reviews — I only want independent ones, no chains."},{"title":"Restaurant discovery by neighborhood","prompt":"Search for open Italian restaurants and pizza places in the Mission District and SoMa neighborhoods of San Francisco, give me up to 30 results with at least a 4.2 rating."},{"title":"Business prospecting with website filter","prompt":"Find up to 200 open plumbing and electrical contractors across Dallas and Houston that have a website — I need them to have at least 15 reviews so they're established."}],"resultDescription":"Returns a JSON object with a status field (e.g. 'processing') and a request_id (UUID) that can be used to retrieve the list of matching businesses once the query completes.","failureModes":["Invalid category or keyword yields no results","Location string not recognized returns empty result set","Limit out of range (below 1 or above 500) may cause validation error","min_rating above 5 or below 0 causes schema error","Async response requires polling request_id for final results","Payment failure via x402 prevents job from being submitted"],"whenToPreferThis":"Use this endpoint when you need to discover multiple local businesses matching geographic and quality criteria — especially when you want to filter by category, star rating, review count, chain status, or website presence. Prefer this over general web search when you need structured, filterable business data rather than unstructured search results.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T12:41:02.033Z","isFirstParty":false,"canonicalSlug":"oneshot-agent-business-finder-e2df383e"}