SEsearchable
Traffic

Get human traffic from AI assistants

Changed on

Human sessions that arrived FROM an AI assistant — total sessions and visitors for the window, the AI-referred share of them, and a per-platform split. The conversion half of the funnel that the crawler reports open. Returns 409 traffic_not_connected if no tracker/CDN/log source is connected.

get/api/mcp/projects/{projectId}/traffic/human

Request

  • Base URL
    https://app.searchable.com
  • Auth
    HTTP bearer

Path parameters

projectIdstring uuid required

The project id.

Query parameters

daysinteger

Lookback window in days. Default and maximum vary by endpoint — see the operation description.

fromstring
Example:2026-03-01

Start of an absolute window (inclusive, UTC). Accepts YYYY-MM-DD or a full ISO timestamp. Requires to, and is mutually exclusive with days — sending both returns 400 invalid_argument. A range longer than the endpoint's maximum is rejected rather than clamped.

tostring
Example:2026-03-31

End of an absolute window (inclusive, UTC). Accepts YYYY-MM-DD or a full ISO timestamp. Requires from.

hoststring
Example:blog.acme.com

Comma-separated hostnames to narrow the report to. Useful on multi-domain projects; omit for every host in the project.

Response

Human traffic summary with the AI-referred breakdown.

summarySource'beacon' | 'unavailable' required

unavailable means no first-party beacon is installed: every summary field is null and the AI figures came from GA4, which shares no denominator with it.

Changes