Get visitor data

GET https://datafa.st/api/v1/visitors/{datafast_visitor_id}

Retrieve identity, activity, and prediction data for a specific datafast_visitor_id. Requires Bearer Token authentication.

Try on Playground

Response

Success (200 OK): Returns a detailed visitor data object.
Errors: See API Introduction. A 400 occurs if the visitor is a bot.

Response fields

See the example response for the structure. Key objects:

identity: Geo-location, device, browser, OS, and first-session parameters derived from the latest pageview.
activity: Visit/pageview counts, timing, last URL, completed goals, and a list of visited pages.
activity.completedGoals: Canonical goal timeline. Includes manually tracked goals and automatic payment-provider goals, sorted by time. Each goal has an origin: manual or payment_provider.
profile: Latest Identify profile for this visitor, including userId, custom metadata, and identifiedAt. Present only when the visitor has been identified.
prediction: Conversion prediction details (rate, USD value, score, confidence). Null if visitor is already a customer or you haven't set up revenue attribution.

Automatic payment-provider goals include payment, free_trial, and subscription lifecycle goals such as trial_started, subscription_started, subscription_renewed, and subscription_ended.

Use prediction to get more sales: Show a lead magnet or coupon to low-converting visitors, or create urgency or exclusivity to high-potential visitors.

✍️ Something missing? Suggest features.

🤖 AI agent or LLM? Read this page as markdown

// Your backend API endpoint const handler = async (req, res) => { const datafast_visitor_id = req.cookies.datafast_visitor_id; try { const response = await fetch(`https://datafa.st/api/v1/visitors/${datafast_visitor_id}`, { method: "GET", headers: { Authorization: `Bearer ${DATAFAST_API_KEY}`, "Content-Type": "application/json", }, }); const result = await response.json(); res.status(200).send(result); } catch (error) { console.error("Error sending goal to DataFast:", error); res.status(500).send("Failed to track goal"); } };

{ "status": "success", "data": { "visitorId": "a3ab2331-989f-4cfa-91c6-2461c9e3c6bd", "identity": { "country": "KR", "countryCode": "KR", "region": "KR-44", "city": "Seosan City", "params": { "ref": "youtube.com", "source": null, "utm_source": null, "utm_medium": null, "utm_campaign": null, "utm_content": null, "utm_term": null }, "browser": { "name": "Chrome", "version": "133.0.0.0" }, "os": { "name": "Mac OS", "version": "10.15.7" }, "device": { "type": "desktop", "vendor": "Apple", "model": "Macintosh" }, "viewport": { "width": 1728, "height": 998 } }, "profile": { "userId": "user@example.com", "metadata": { "name": "Jane Doe", "plan": "pro" }, "identifiedAt": "2025-04-11T03:39:10.000Z" }, "activity": { "visitCount": 3, "pageViewCount": 8, "timeSinceFirstVisit": 3296041, // in milliseconds "timeSinceCurrentVisit": 3296041, // in milliseconds "firstVisitAt": "2025-04-11T03:38:49.154Z", "lastVisitAt": "2025-04-11T03:38:49.154Z", "currentUrl": "codefa.st/", "visitedPages": [ { "url": "codefa.st/", "timestamp": "2025-04-11T03:38:49.154Z" }, ] "completedGoals": [ { "type": "custom", "origin": "manual", "name": "newsletter_signup", "description": "Sign up for the newsletter", "isServer": false, "timestamp": "2025-04-11T03:38:54.253Z" }, { "type": "payment", "origin": "payment_provider", "name": "payment", "provider": "stripe", "providerCustomerId": "cus_123", "providerSubscriptionId": "sub_123", "amount": 49, "currency": "USD", "timestamp": "2025-04-11T03:45:12.000Z" }, { "type": "subscription_lifecycle", "origin": "payment_provider", "name": "subscription_started", "provider": "stripe", "providerCustomerId": "cus_123", "providerSubscriptionId": "sub_123", "mrrDelta": 49, "currency": "USD", "timestamp": "2025-04-11T03:45:12.000Z" } ], }, "prediction": { "score": 72, // (0-100) how likely is this visitor to convert? 50 is your baseline/average, 100 is very likely to convert, 0 is very unlikely to convert "conversionRate": 0.0138, // predicted conversion rate (1.38% chance to convert here) "expectedValue": 3.089, // predicted revenue in USD (predicted conversion rate * predicted order value) "confidence": 0.831, // (0-1) our confidence level based on data points analyzed. The higher the number, the more accurate the predictions. don't make important decisions if confidence is <0.5 } } }