Source: https://datafa.st/docs/api/website/visitors
Markdown source: https://datafa.st/docs/api/website/visitors.md
Description: Search visitors and retrieve full visitor profiles, activity, goals, payments, and predictions.

# 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](/docs/api/website/visitors/list) | GET | `/api/v1/visitors` | Search visitors by behavior, source, location, device, campaign, or customer status |
| [Get visitor](/docs/api/website/visitors/retrieve) | 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`.

```http
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](/docs/api/website/identity/identify)
- Activity: visits, pages, completed goals, payments
- Prediction: conversion score when available

```http
GET /api/v1/visitors/a3ab2331-989f-4cfa-91c6-2461c9e3c6bd
```

## Authentication

- `df_` website API key for one website. No `websiteId` query parameter required.
- `dft_` account token with `analytics:read`. Pass `websiteId` as a query parameter.

See [authentication and scopes](/docs/api/authentication).

## Code examples

### Search visitors

```bash
curl -X GET "https://datafa.st/api/v1/visitors?visitedPage=/pricing&completedGoal=signup&limit=100" \
  -H "Authorization: Bearer df_xxx"
```

### Success response

```json
{
  "status": "success",
  "data": [
    {
      "visitorId": "a3ab2331-989f-4cfa-91c6-2461c9e3c6bd",
      "lastSeenAt": "2026-05-05T12:00:00Z",
      "currentUrl": "example.com/pricing",
      "identity": {
        "country": "US",
        "browser": "Chrome",
        "device": "desktop"
      }
    }
  ],
  "pagination": {
    "limit": 100,
    "offset": 0,
    "hasMore": false
  }
}
```