website_sessions

Search website sessions

The visitor feed: every visit to the team's sites, newest first, as one session: who it belongs to when a rung named someone (person_sid, or company_sid when only a company code or the network did; attribution says which), what was seen (pages with engaged time, key_pages, events: forms and custom events), where it came from (referrer_type, the utm set, landing_code), the browser and the network (network_type business, isp, mobile, hosting, education, government or unknown; network_name, network_domain). Scope with site_sid, started_at (the period) and the sids of a person, a company or a visitor; key_page, form and event take a slug or a name (eq or in), and is_null false = any whatever the name (every session that submitted a form, anonymous ones included), true = none; person_sid is_null false = known people, closed_at is_null true = on the site now, is_internal eq true = the team's own traffic. page_size 0 returns the counts by attribution, network type, referrer type, device and key page. "Who visited pricing this week and has not replied": this with key_page pricing and a started_at window, then search_people or search_conversations by the signals visited_key_page and visited_not_replied. What a session saw is private context: use it to decide when to write and what to offer, never tell the lead we know.

Contract:

  • MCP tool search_website_sessions, registry package mcp.signals/website_sessions, mount signals.visits.
  • Operation search, response envelope search.
  • Flags: read only.
post/api/website-sessions/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.