Visitors API
Use the Visitors API to find visitors by behavior, then inspect a single visitor journey in detail.
These endpoints are useful for enrichment workflows, CRM handoff, support tooling, and AI agents that need to answer questions like "who visited pricing and signed up?".
| Endpoint | Method | Path | Purpose |
|---|---|---|---|
| List visitors | GET | /api/v1/visitors | Search visitors by behavior, source, location, device, campaign, or customer status |
| Get visitor | GET | /api/v1/visitors/{datafast_visitor_id} | Get one visitor's identity, profile, activity, goals, payments, and prediction data |
List visitors
GET https://datafa.st/api/v1/visitors
Query parameters include
startAt, endAt, limit, offset, visitedPage, visitedPageContains, completedGoal, country, device, browser, utm_campaign, and isCustomer.GET /api/v1/visitors?visitedPage=/pricing&completedGoal=signup&limit=100
Get visitor
GET https://datafa.st/api/v1/visitors/{datafast_visitor_id}
Use this after list visitors returns an ID. The response includes:
- Identity: country, browser, OS, device, URL params
- Profile: user ID and metadata from Identify users
- Activity: visits, pages, completed goals, payments
- Prediction: conversion score when available
GET /api/v1/visitors/a3ab2331-989f-4cfa-91c6-2461c9e3c6bd
Authentication
df_website API key for one website. NowebsiteIdquery parameter required.dft_account token withanalytics:read. PasswebsiteIdas a query parameter.