Better Searching
The Visitor searching endpoint works with any type of text and will perform a fuzzy search through all your Visitors. We also have special tokens that make the search faster and more accurate.
Search Formats and Examples
| Format | Example | Index Used |
|---|---|---|
| Any email | john@example.com | Any email provided through uniqueId or identities. |
online | online | Filters online visitors only. |
-online | -online | Filters offline visitors only. |
ip: + the IP | ip:1.1.1.1 | Shows visitors with IP 1.1.1.1. |
id: + the ID | id:user123 | Shows visitors with uniqueId equal to user123. |
| A four-digit number | 1234 | Shows visitors with the 1234 lookup code. |
| Any tags | #client | Shows visitors with the #client tag. |
integration_id: + integration name + : + integration id | integration_id:acmechat:1234 | Shows visitors with integration id acmechat equal to 1234. |
Searching for One?
If you are only searching for a single Visitor, make sure you set
max_results to 1 to make the search faster. It will return as soon as one of our datacenters finds something, and they tend to respond more quickly when they do find a Visitor in their database.