Signals

The Signals API surfaces timely, sales-relevant events detected on a company's domain — e-commerce growth, ad-network adoption, technology installs, buyer intent, company news, and traffic shifts — so sales and marketing teams can prioritize outreach at the right moment.

Recommended flow:

1. Start with Describe. Call the Signals - Describe endpoint first to discover the available date range and supported granularity for each signal type. This tells you the freshest data window before you query anything else.
2. Use those values in your signal request. Take the start_date, end_date, and granularity returned by Describe and pass them as query parameters into the specific signal endpoint you want (E-commerce, Ad Network, Technology, Intent, News, or Traffic).
3. Read the response. Every signal endpoint returns the same envelope — a meta object plus a data array of signal records. If no signals are found for the selected timeframe, you'll still get a successful 200 response with an informational message rather than an error.

Signal types available:

• Intent — buyer intent topic activity by country and metro area
• Technology — technology stack additions, removals, and upcoming renewals
• Traffic — significant traffic changes and new market entries
• E-commerce — revenue and transaction-volume changes
• Ad Network — started/stopped working with an ad network
• News — categorized company news (funding, M&A, leadership changes, etc.)

Each signal type is independently entitled, so access may vary by account. All endpoints share the same authentication (api_key) and base request pattern — only the response fields differ by signal type.