website_visitors

Search website visitors

The browsers that visited the team's sites, one row per browser per site: the person it is bound to (person_sid, bound_by: code, identify, fingerprint or manual), the email an identify or a form gave when nobody matched (identified_email: the "Add to table" rows), how often it came (sessions_count), when (first_seen_at, last_seen_at), and what the newest session told about the browser, the place and the network. identified_email is_null false with person_sid is_null true = emails nobody has yet; person_sid eq = one person's browsers ("the same person on two devices"); is_ephemeral eq false hides the one-day strangers. q searches the email and the network name. page_size 0 returns the counts by bound_by and network type. The visits themselves are search_website_sessions; people by a signal are search_people. Private context: never tell the lead we know.

Contract:

  • MCP tool search_website_visitors, registry package mcp.signals/website_visitors, mount signals.visits.
  • Operation search, response envelope search.
  • Flags: read only.
post/api/website-visitors/search

Request

  • Base URL
    https://beta.getsales.io/signals/v1
  • Auth
    HTTP bearer and API key in header Team-SID

Request body

includestring[]

Relations to attach to every item; omit for the bare rows.

page_sizeinteger

0..500, default 50; 0 = counts only, 1 = the first row.

cursorstring nullable

pagination.next_cursor of the previous page.

Response

search success envelope.

successtrue required
operation'search' required
applied_filtersobject required
includesstring[] required

Changes

No recorded changes to this operation across all 1 revision of this API.