{"uid":"cap_zFGLIZnj-Cm4HiJUvHoqF","slug":"disruption-intelligence-ripple-brief-api-4c6e91da","name":"Disruption Intelligence Ripple Brief API","description":"Returns the Disruption Intelligence Ripple Report: a ranked brief with headline, top regions, recommended actions, and delivered signals on downstream business effects from workforce disruption","url":"https://disruption.forgemesh.io/ripple/brief","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"q":{"type":"string","description":"Optional commercial angle, company, region, or industry search query"},"limit":{"type":"number","description":"Maximum delivered signals to include (max 10, default 5)"},"scope":{"type":"string","description":"all, gold, or watchlist"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","additionalProperties":true}}}}},"responseSchema":{"type":"json","example":{"product":"disruption_intelligence_ripple_report","readout":{"headline":"Commercial signal headline","why_it_matters":"Why the buyer should care now.","commercial_angle":"A compact commercial interpretation."},"inventory":{"gold":0,"fresh":0,"matches":0,"watchlist":0},"navigation":{"message":"Use q to focus the brief; use delivered_signals[].ripple_path_inventory.unlock_endpoint for deeper downstream impact paths.","examples":["/ripple/brief?q=Meta&limit=5","/ripple/brief?q=logistics&scope=gold&limit=5"]},"report_name":"Disruption Intelligence Ripple Report","why_not_high":["The brief is a ranked commercial readout, not proof that a buyer, vendor, or region will act.","Coverage can lag real-world changes, filings, local updates, and follow-on commercial activity."],"delivered_signals":[],"recommended_actions":["Review exposed accounts, territories, or sales motion."]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","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.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ScD39q9HCPFw992dzHeOs","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a ranked commercial readout of downstream business disruption signals derived from WARN filings, labor events, and regional economic data","exampleAgentPrompt":"Pull me a disruption intelligence ripple brief focused on the logistics industry — give me up to 5 gold-tier signals so I can see which downstream businesses are most exposed right now.","exampleUseCases":[{"title":"Protect customer base from supplier disruptions","prompt":"Get me a disruption brief for the semiconductor supply chain. I need to know which of our key accounts might be hit by layoffs or closures so I can proactively reach out before they call us."},{"title":"Find sales targets in affected regions","prompt":"Show me the top regions right now with active labor disruption signals. I want to identify companies that might need our services because they're dealing with workforce challenges or supply chain issues."},{"title":"Monitor economic risk in target sectors","prompt":"Give me a commercial disruption intelligence read on the automotive and manufacturing sectors. I'm tracking which industries are most exposed to WARN filings so I know where to focus my prospecting efforts."}],"resultDescription":"A JSON object containing a headline commercial signal, a why-it-matters summary, a compact commercial angle, signal inventory counts (gold, fresh, watchlist, matches), a list of delivered disruption signals with ripple path inventory and unlock endpoints, recommended actions, and navigational hints for deeper investigation.","failureModes":["Invalid scope value (not 'all', 'gold', or 'watchlist') returns a validation error","limit exceeding 10 is clamped or rejected","No matching signals for the given query returns empty delivered_signals array with inventory counts of zero","Payment failure (insufficient USDC balance or x402 protocol error) prevents response","Stale or lagging data may result in signals that do not reflect the most recent real-world filings"],"whenToPreferThis":"Use this endpoint when you need a fast commercial intelligence brief on labor disruption ripple effects — particularly when selling into or monitoring accounts exposed to WARN filings, regional layoffs, or economic contraction events. Prefer this over generic news APIs or economic data feeds when you need pre-interpreted commercial angles and downstream impact paths, not raw data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:35:04.160Z","isFirstParty":false}