Get one or more identification events, including Smart Signals, via searching.
Please note that the response includes mobile signals (e.g. rootApps) even if the request originated from a non-mobile platform.
It is highly recommended that you ignore the mobile signals for such requests.
If a start or end time are not supplied, the default search range is the last 7 days.
Search
The /search endpoint provides a convenient way to search for past events based on specific parameters. Typical use cases and queries include:
- Searching for events associated with a single
visitorIDwithin a time range to get historical behavior of a visitor. - Searching for events associated with a single
linkedIDwithin a time range to get all events associated with your internal account identifier. - Excluding all bot traffic from the query (
goodandbadbots)
By default, the search is performed on events that are one week old.
Filtering events with thesuspect flag
suspect flagThe /search endpoint unlocks a powerful method for fraud protection analytics. The suspect flag is exposed in all events where it was previously set by the update API.
You can also apply the suspect query parameter as a filter to find all potentially fraudulent activity that you previously marked as suspect. This helps identify patterns of fraudulent behavior.