{"uid":"cap_Wv31YH9Xw6p5vv1fbNJMt","slug":"business-change-intelligence-api-event-search-322807d9","name":"Business Change Intelligence API – Event Search","description":"Find previously unknown businesses or locations with recent license, permit, inspection, ownership, opening, closure, or tenant-transition signals. Use for market research, sales prospecting, expansion tracking, and location intelligence. Results are compact by default and always distinguish regulatory leads from confirmed public status.","url":"https://api.businesschanges.dev/v1/events/search","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer","default":25,"maximum":100,"minimum":1},"cursor":{"type":"string","maxLength":512,"minLength":1},"intents":{"type":"array","items":{"enum":["opening_leads","construction_activity","remodels","operator_changes","closure_risk","compliance_activity"],"type":"string"},"maxItems":6,"minItems":1},"geography":{"type":"object","properties":{"near":{"type":"object","required":["latitude","longitude","radiusKm"],"properties":{"latitude":{"type":"number","maximum":90,"minimum":-90},"radiusKm":{"type":"number","maximum":250,"exclusiveMinimum":0},"longitude":{"type":"number","maximum":180,"minimum":-180}},"additionalProperties":false},"cities":{"type":"array","items":{"type":"string","minLength":1},"maxItems":25,"minItems":1},"counties":{"type":"array","items":{"type":"string","minLength":1},"maxItems":25,"minItems":1},"postalCodes":{"type":"array","items":{"type":"string","maxLength":16,"minLength":3},"maxItems":50,"minItems":1},"regionCodes":{"type":"array","items":{"type":"string","maxLength":16,"minLength":2},"maxItems":25,"minItems":1}},"additionalProperties":false},"eventTypes":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9]+(?:[._-][a-z0-9]+)+$","maxLength":100,"minLength":3},"maxItems":25,"minItems":1},"industries":{"type":"array","items":{"type":"string","maxLength":80,"minLength":1},"maxItems":25,"minItems":1},"projection":{"enum":["compact","standard","full"],"type":"string","default":"compact"},"jurisdictions":{"type":"array","items":{"type":"string","pattern":"^[A-Z0-9][A-Z0-9._-]*$","maxLength":64,"minLength":2,"description":"Stable jurisdiction code such as US-FL."},"maxItems":25,"minItems":1},"observedAfter":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"ISO 8601 timestamp with an explicit timezone offset."},"effectiveAfter":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"ISO calendar date in YYYY-MM-DD form."},"effectiveBefore":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"ISO calendar date in YYYY-MM-DD form."},"minEvidenceStrength":{"enum":["weak","moderate","strong","authoritative"],"type":"string","default":"strong"},"minClassificationConfidence":{"type":"number","default":0.75,"maximum":1,"minimum":0}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_MpziND8aPJlTKnostbzQS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search for businesses or locations with recent regulatory, operational, or ownership-change signals using intent filters, geography, and industry to surface sales leads and market intelligence.","exampleAgentPrompt":"Find me up to 50 new opening leads for restaurants within 30 km of Chicago — licensed or permitted in the last 60 days — and return the results in standard projection so I can see enough detail for prospecting.","exampleUseCases":[{"title":"Restaurant Sales Prospecting in Metro Area","prompt":"Show me up to 30 new restaurant or food service businesses that have gotten opening permits or licenses in Los Angeles in the past 90 days — I'm looking for leads for our equipment leasing sales team, use standard detail."},{"title":"Commercial Real Estate Tenant Transition Tracking","prompt":"Find operator changes and tenant transitions in retail locations across zip codes 10001, 10002, and 10003 in New York — I want to spot vacancies and new tenants for our commercial brokerage, limited to the last 60 days."},{"title":"Construction Activity Monitoring for a Sales Territory","prompt":"Search for construction activity and remodel signals within 50 km of Austin, TX for any industry — observed after January 1 2025 — and give me up to 100 results so I can identify prospects for our contractor supply business."}],"resultDescription":"A paginated list of compact (or standard/full) business-change event records, each distinguishing regulatory leads from confirmed public status, including event type, business/location identity, geography, industry, and a cursor for fetching the next page.","failureModes":["No events found for the specified geography or filters — empty result set","Invalid geography coordinates (lat/lon out of bounds) — validation error","Unsupported intent enum value — schema validation error","observedAfter date malformed or out of range — 400 error","Exceeds maximum limit (100) or maxItems for arrays — validation error","Payment not attached or insufficient (x402 protocol required) — 402 Payment Required","Rate limit exceeded — 429 Too Many Requests"],"whenToPreferThis":"Use this endpoint when you need to discover new or recently changed businesses across a geographic area using intent-based filters (openings, closures, permits, construction, operator changes). It is the right starting point for prospecting workflows before using the sibling evidence-expansion or premises-detail endpoints. Prefer it over general web search when you need structured, regulatory-signal-backed business change data rather than unstructured web results.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:41:46.283Z","isFirstParty":false}