Sign in

v3

latestOpenAPI 3.1.1mit2026-07-3165481.5 MB
Web Visits
v1

Search Web Visits

Search for web visits within a date range. Returns a paginated list of visit records including engagement data, visitor information, and location.

:::info Requires the web_visits:read OAuth2 scope. :::

post/v1/web-visits

Query parameters

account_idstring required

The Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.

page[num]integer

Page of results to fetch.

page[size]integer

The number of items per page. Maximum is 100.

include'company'

Specify which additional data should be attached to the result.

Request body

start_datestring date required

The start of the date range to search (inclusive). Must be a valid ISO 8601 date.

end_datestring date required

The end of the date range to search (inclusive). Must be a valid ISO 8601 date.

Example request

{
  "start_date": "2026-01-01",
  "end_date": "2026-01-31",
  "filters": {
    "company_id": "abc123",
    "location_cities": [
      "Munich",
      "Berlin"
    ],
    "location_country_codes": [
      "DE",
      "AT"
    ]
  }
}

Response

Success

Example response

{
  "data": [
    {
      "type": "web_visit",
      "id": "5b4f313e-46de-11e8-b981-05bebed8e58b",
      "attributes": {
        "started_at": "2026-01-15T10:30:00.000Z",
        "source": "google",
        "medium": "cpc",
        "campaign": "HomePage Split",
        "referring_url": "https://www.google.com/search?q=dealfront",
        "keyword": "website leads",
        "landing_page_path": "/home",
        "page_depth": 4,
        "visit_length": 80,
        "device_type": "smartphone",
        "identifiers": {
          "lf_client_id": "LF1.1.a3f8b2d1e4c90123.1742597607000",
          "ga_client_ids": [
            "5829104736.1742616961"
          ],
          "adobe_cookies": [
            {
              "MCMID": "681245",
              "MCAAMB": "RKh123Vc5",
              "MCAAMLH": "6"
            }
          ]
        },
        "visitor": {
          "email": "john.doe@example.com",
          "first_name": "John",
          "last_name": "Doe"
        },
        "engagements": [
          {
            "id": "b4ebc08c-8c1f-11f1-9b9e-633b755451a0_0",
            "time": "2026-07-29T05:00:00+02:00",
            "hostname": "www.leadfeeder.com",
            "page": {
              "path": "/pricing/",
              "title": "Pricing for all stages of growth",
              "url": "http://www.leadfeeder.com/pricing/"
            },
            "previous_page_path": "(entrance)",
            "time_on_page": 22
          }
        ]
      },
      "relationships": {
        "location": {
          "type": "visit_location",
          "id": "6xeTMh2VfiAzFd86n7GNJ3",
          "attributes": {
            "country": "Finland",
            "country_code": "FI",
            "region": "Uusimaa",
            "city": "Helsinki",
            "geonames_id": "658225"
          }
        },
        "company": {
          "id": "129011"
        }
      }
    }
  ],
  "meta": {
    "pagination": {
      "page_num": 1,
      "page_count": 1,
      "total_count": 1
    },
    "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
  }
}