Company Advertisement Insights
Aggregated advertising-signal insights for a company over a date window: active and launched ad counts, channel and placement mix, creative samples, audience reach as a tier distribution, and a weekly time series. Reach is reported as a distribution across tiers, never as a single summed figure.
Authorizations
Body
A unique identifier for the company search operation.
Start of the date window (ISO 8601, YYYY-MM-DD). Use together with date_to to scope results to a specific range; omit both to use the default window.
"2026-01-01"
End of the date window (ISO 8601, YYYY-MM-DD). Must be on or after date_from.
"2026-03-31"
Optional. An identifier for the user profile (workspace) making the request. This is no longer required as the API key already includes your workspace information. If provided, it helps in associating the lookup with a specific user, allowing for data retrieval and credit tracking.
Check out user details endpoints under the Profile tab for more information.
Include advertisements not yet linked to a verified company profile.
false
Response
Advertising insight bands for the company and window.
Insight bands for the requested company and window.

