Website Visitor ID
Identify the companies and consenting people visiting your site, delivered by webhook.
curl -X POST https://api.1lookup.dev/v1/website-visitor-id \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"ip":"203.0.113.42"}'{
"success": true,
"data": {
"site": "example.com",
"visitor_id": "vis_8f3k2m9q4x",
"identified_at": "2026-11-12T15:42:08Z",
"match_level": "person",
"company": {
"name": "Fabrikam Health",
"domain": "fabrikam.example",
"industry": "Health care technology",
"employee_range": "501-1000",
"country": "US"
},
"person": {
"full_name": "Priya Raman",
"job_title": "Head of Revenue Operations",
"email": "priya.raman@example.com",
"consented": true
},
"visit": {
"landing_page": "https://example.com/pricing",
"referrer": "https://news.example/revops-tools",
"pages_viewed": 4,
"duration_seconds": 213,
"country": "US"
}
},
"meta": {
"credits_used": 50,
"credits_remaining": 999,
"cached": false,
"request_id": "req_8f3a2c1e9b7d"
}
}Authorization
Authorizationstring<bearer>requiredYour API key as a Bearer token. Live keys start with 1lk_live_. Test keys start with 1lk_test_ and return this endpoint's sample response without spending credits. See authentication.
Body
Send the fields as a JSON object with Content-Type: application/json.
ipstring<ip>requiredIP address. IPv4 or IPv6 Example: 203.0.113.42
page_urlstring<uri>Page URL. Example: https://example.com/pricing
freshbooleanSkip the 7-day cache and run a new lookup. Charged as a normal lookup.
referencestringYour own identifier, echoed back in meta and shown in lookup history.
Response
A 200 response carries the result in data and the cost of the call in meta. These are the fields most integrations read.
successbooleantrue when the lookup ran.
data.match_levelstringcompany or person. Person-level matches happen only for consenting visitors in the US.
data.company.namestringThe organization the visitor was matched to.
data.company.domainstringThe matched company's website, a clean key for your CRM.
data.company.employee_rangestringHeadcount band for qualifying the account.
data.personobjectName, job title and email for a consenting US visitor. Null on company-level matches.
data.visit.landing_pagestringThe first page of the session, with referrer, page count and duration beside it.
data.identified_atstringUTC timestamp for when the visitor was identified.
meta.credits_usednumberCredits charged for this call.
meta.credits_remainingnumberYour balance after the call.
meta.cachedbooleantrue when the result came from the 7-day cache.
meta.request_idstringQuote this when you contact support.
Errors
A failed request returns success: false with an error object, and is never charged. The full list is on the errors page.
| HTTP | Code | Meaning |
|---|---|---|
| 401 | unauthorized | The key is missing, malformed or revoked. |
| 402 | insufficient_credits | Your credits are used up and pay as you go is off or at its limit. |
| 403 | approval_required | This product has not been switched on for your account yet. |
| 422 | invalid_input | A field is missing or malformed. The field property names it. |
| 429 | rate_limited | Too many requests for this key. Wait for the Retry-After interval. |
| 500 | internal_error | Something failed on our side. Safe to retry. |
| 503 | source_unavailable | An upstream source did not answer in time. Safe to retry. |
Billing
50 credits / identified visitor. Charged when the lookup runs and returns a result. Errors are never charged, and repeating the same input within 7 days is served from cache at no charge. This product needs approval before it is enabled on your account.
Product overview and use cases