1. Web Visits
Leadfeeder API (BETA)
  • Introduction
  • Authentication
  • Rate Limits
  • Relationships
  • Company ID Lifecycle
  • OpenAPI Specification Access
  • Account
    • List Accounts
  • Companies
    • Get Company Details
    • Retrieve Companies
    • Company Financial Reports
    • Search Company Signals
    • Search Companies
    • Match Companies
    • Add Company to Lists
    • Remove Company from Lists
    • Assign Tags to Company
    • Unassign Tags from Company
  • Contacts
    • Get Contact Details
    • Retrieve Contacts
    • Search Contacts
    • Add Contact to Lists
    • Remove Contact from Lists
  • Web Visits
    • How to Create Custom Feed
    • Custom Feed - Filter Reference
    • Search Web Visits
      POST
    • Retrieve Custom Feeds
      GET
    • Create a Custom Feed
      POST
    • Get Custom Feed Details
      GET
    • Update Custom Feed
      PATCH
    • Delete a Custom Feed
      DELETE
    • Retrieve Custom Feeds Folders
      GET
    • Retrieve Web Visits Tracker Script
      GET
    • Retrieve Visitor Companies
      GET
  • IP
    • Enrich Company IP Address
  • Tags
    • Retrieve Tags
    • Create Tag
    • Get Tag Details
    • Update Tag
    • Delete Tag
  • Lists
    • Retrieve Lists
    • Create a List
    • Get List Details
    • Update List
    • Delete List
  • Custom Fields
    • Retrieve Custom Fields
    • Create Custom Field
    • Get Custom Field Details
    • Update Custom Field
    • Delete Custom Field
  • Usage
    • Get Endpoints Usage
  • Reference Data
    • List of NACE / WZ codes
  • Schemas
    • Schemas
    • Response
    • AccountResponse
    • VisitLocationV1
    • IcpV1
    • LocationV1
    • CRMUserV1
    • CRMOrganizationV1
    • CRMContactV1
    • CRMLeadV1
    • WebVisitV1
    • CRMConnectionV1
    • BuyerPersonaV1
    • CRMSuggestionV1
    • IpLocationV1
    • CRMGroupConnectionV1
    • CustomFeedRequestV1
    • AccountV1
    • MaskedContactSummaryV1
    • CustomFeedV1
    • CustomFeedFolderV1
    • WebVisitsTrackerScriptV1
    • CompanyLocationV1
    • Error401
    • AccountSummaryV1
    • Error403
    • ErrorObjectV1
    • MaskedCompanySummaryV1
    • CompanyV1
    • Error429
    • NetworkV1
    • CompanyFinancialsV1
    • Error404
    • Error500
    • SignalV1
    • Error504
    • CompanyResponse
    • CompanySummaryV1
    • CompaniesResponse
    • CompanyFinancialsResponse
    • CompaniesSignalsResponse
    • CompaniesSearchResponse
    • TagV1
    • ListV1
    • CompanyMatchV1
    • ContactResponse
    • CustomFieldV1
    • ContactV1
    • ContactsResponse
    • ContactSummaryV1
    • ContactsSummaryResponse
    • EnrichedIpV1
    • IpEnrichResponse
    • TagsResponse
    • ListsResponse
    • ApiUsageV1
    • ApiUsageResponse
    • Error400
    • TagResponse
    • ListResponse
    • TagDeleteResponse
    • ListDeleteResponse
    • EmptySuccessResponse
    • CustomFieldsResponse
    • CustomFieldResponse
  1. Web Visits

Search Web Visits

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

Request

Authorization
API Key
Add parameter in header
X-Api-Key
Example:
X-Api-Key: ********************
or
Query Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK
application/json
Success
Body

🟠400Bad Request
🟠401Unauthorized
🟠403Forbidden
🟠429
🔴500Server Error
🔴504Gateway Timeout
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location -g --request POST 'https://api.leadfeeder.com/v1/web-visits?account_id=123456&page[num]=1&page[size]=20&include=company' \
--header 'X-Api-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "start_date": "2026-01-01",
    "end_date": "2026-01-31"
}'
Response Response Example
200 - Example 1
{
    "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": [
                    {
                        "hostname": "www.leadfeeder.com",
                        "page": {
                            "path": "/pricing/",
                            "title": "Pricing for all stages of growth",
                            "url": "http://www.dealfront.com/pricing/"
                        },
                        "previous_page_path": "(entrance)",
                        "has_met_goals": false,
                        "event_type": "page-view",
                        "time_on_page": 22
                    }
                ]
            },
            "relationships": {
                "location": {
                    "type": "visit-location",
                    "id": "6xeTMh2VfiAzFd86n7GNJ3",
                    "attributes": {
                        "country": "Finland",
                        "country_code": "FI",
                        "region": "Uusimaa",
                        "city": "Helsinki",
                        "geonames_id": "658225",
                        "postal_code": "string"
                    }
                },
                "company": {
                    "id": "129011",
                    "type": "company"
                }
            }
        }
    ],
    "meta": {
        "pagination": {
            "page_num": 1,
            "page_count": 1,
            "total_count": 1
        },
        "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
    }
}
Modified at 2026-04-14 13:35:01
Previous
Custom Feed - Filter Reference
Next
Retrieve Custom Feeds
Built with