Skip to content
IP & Network

Website Visitor ID

Identify the companies and consenting people visiting your site, delivered by webhook.

POST/v1/website-visitor-id
50 credits / identified visitorApprovalCompany-level global, person-level US only
Request
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"}'
Response
{
  "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>required

Your 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>required

IP address. IPv4 or IPv6 Example: 203.0.113.42

page_urlstring<uri>

Page URL. Example: https://example.com/pricing

freshboolean

Skip the 7-day cache and run a new lookup. Charged as a normal lookup.

referencestring

Your 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.

successboolean

true when the lookup ran.

data.match_levelstring

company or person. Person-level matches happen only for consenting visitors in the US.

data.company.namestring

The organization the visitor was matched to.

data.company.domainstring

The matched company's website, a clean key for your CRM.

data.company.employee_rangestring

Headcount band for qualifying the account.

data.personobject

Name, job title and email for a consenting US visitor. Null on company-level matches.

data.visit.landing_pagestring

The first page of the session, with referrer, page count and duration beside it.

data.identified_atstring

UTC timestamp for when the visitor was identified.

meta.credits_usednumber

Credits charged for this call.

meta.credits_remainingnumber

Your balance after the call.

meta.cachedboolean

true when the result came from the 7-day cache.

meta.request_idstring

Quote 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.

HTTPCodeMeaning
401unauthorizedThe key is missing, malformed or revoked.
402insufficient_creditsYour credits are used up and pay as you go is off or at its limit.
403approval_requiredThis product has not been switched on for your account yet.
422invalid_inputA field is missing or malformed. The field property names it.
429rate_limitedToo many requests for this key. Wait for the Retry-After interval.
500internal_errorSomething failed on our side. Safe to retry.
503source_unavailableAn 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