{"uid":"cap_nuezzHB4fUJjpPKYgUgBB","slug":"business-change-intelligence-delta-feed-api-1802b2e0","name":"Business Change Intelligence Delta Feed API","description":"Poll a compact, stable delta feed of events first observed since a timestamp or prior cursor, including superseded and retracted events. Use for recurring research and monitoring agents.","url":"https://api.businesschanges.dev/v1/changes","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer","default":50,"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},"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."},"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.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_imdmrZcaKG4jEWBfH6PuT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Poll a cursor-based delta feed of business change events (openings, closures, construction, operator changes, compliance activity) observed since a given timestamp or prior cursor, with filtering by jurisdiction, intent, and evidence strength.","exampleAgentPrompt":"Poll the Business Change Intelligence delta feed for new opening leads and construction activity events in US-FL and US-TX observed since 2025-06-01T00:00:00Z, using strong evidence strength, and return up to 50 compact results.","exampleUseCases":[{"title":"Sales lead monitoring for new business openings","prompt":"Every morning, check for new business opening leads in US-CA and US-NY that appeared since yesterday at midnight, with at least strong evidence, and send me a summary of what came in — keep it compact, up to 50 results."},{"title":"Construction activity tracker for commercial real estate","prompt":"Pull all construction activity and remodel events in US-TX observed since 2025-05-01T00:00:00Z with authoritative evidence strength and a classification confidence above 0.85 — give me the standard projection so I can assess each property."},{"title":"Closure risk alerting for franchise portfolio","prompt":"I need to check for any closure risk or compliance activity changes across US-IL, US-OH, and US-MI since my last run — use the cursor abc123xyz to pick up where I left off, and flag anything with at least moderate evidence strength."}],"resultDescription":"A paginated delta feed of business change events scoped to the requested jurisdictions and intents, each annotated with classification confidence, evidence strength, and event type (opening lead, construction, remodel, operator change, closure risk, or compliance activity). Includes a next-cursor for subsequent polling and may include superseded or retracted events for reconciliation.","failureModes":["Invalid or expired cursor returns an error requiring a fresh observedAfter timestamp","Jurisdiction codes not matching the required pattern cause a validation error","Requesting more than 100 results per call is rejected","An observedAfter timestamp without an explicit timezone offset fails pattern validation","No matching events for the given filters returns an empty result set with a fresh cursor","Insufficient evidence strength or confidence thresholds may return no events even when changes exist"],"whenToPreferThis":"Choose this endpoint for recurring, automated monitoring workflows where you need incremental updates since a prior run rather than a full dataset refresh. It is ideal for agent loops that poll on a schedule, use cursor-based pagination to avoid re-processing seen events, and need to handle superseded or retracted events. Prefer it over the full event retrieval endpoint when you want compact payloads and efficient delta detection across multiple jurisdictions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:31:48.239Z","isFirstParty":false}