Web Visits

Retrieve Visitor Companies

Changed on Oct 23, 2026

Retrieve a paginated list of companies that visited your website within a given date range. Each item includes references to the company and its inferred geographic location.

Order the list with sort[field] and sort[direction]. Without either, the companies that visited most recently come first. sort[direction] defaults to asc, so for the highest intent score first pass sort[field]=intent_score&sort[direction]=desc.

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

get/v1/web-visits/companies

Request

Base URL
https://api.leadfeeder.com
URL
https://api.leadfeeder.com/v1/web-visits/companies
Auth
- API key in header X-Api-Key
- or OAuth 2
  Authorization code: https://api.leadfeeder.com/v1/oauth/authorize
  Token URL: https://api.leadfeeder.com/v1/oauth/token scopes: web_visits:read

Query parameters

account_idstring required

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

start_datestring date required

Start of the date range (ISO 8601).

end_datestring date required

End of the date range (ISO 8601).

page[num]integer

Page of results to fetch.

page[size]integer

The number of items per page. Maximum is 100.

custom_feed_idstring

Filter results to companies matching a specific custom feed.

include'company'

Specify which additional data should be attached to the result.

sort[field]'intent_score' | 'last_visit'

Attribute to sort the companies by. This endpoint sorts on a single attribute, so a comma-separated list is rejected with invalid_parameter, as is any other value, an empty one included. Without it, a sort[direction] on its own orders by last_visit. Omit both sort parameters to get the most recent visitors first.

sort[direction]'asc' | 'desc'

Sort direction. Defaults to asc.

Response

Success

Example response

{
  "data": [
    {
      "id": "5b4f313e-46de-11e8-b981-05bebed8e58b",
      "relationships": {
        "company": {
          "id": "129011"
        },
        "location": {
          "attributes": {
            "city": "Helsinki",
            "country": "Finland",
            "country_code": "FI",
            "geonames_id": "658225",
            "region": "Uusimaa",
            "region_code": "FI-18",
            "state_code": "FI-18"
          },
          "id": "6xeTMh2VfiAzFd86n7GNJ3",
          "type": "location"
        }
      },
      "type": "company_location"
    }
  ],
  "meta": {
    "pagination": {
      "page_count": 1,
      "page_num": 1,
      "total_count": 1
    },
    "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
  }
}

Changes

Oct 23, 2026ac0233075c0a Revision changes
- info
  added the new optional query request parameter sort[direction]
- info
  added the new optional query request parameter sort[field]
Oct 22, 2026ff9df8ba8977 Revision changes
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property ////////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property ////////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property ////////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  response property data/items/relationships/company/oneOf[CompanyV1]/relationships/crm_connections/items/relationships/crm_record/oneOf[CRMContactV1]/relationships/crm_owner/oneOf[CRMUserV1]/attributes/first_name deprecated
- info
  response property data/items/relationships/company/oneOf[CompanyV1]/relationships/crm_connections/items/relationships/crm_record/oneOf[CRMLeadV1]/relationships/crm_owner/oneOf[CRMUserV1]/attributes/first_name deprecated
- info
  response property data/items/relationships/company/oneOf[CompanyV1]/relationships/crm_connections/items/relationships/crm_record/oneOf[CRMOrganizationV1]/attributes/zip_code deprecated
- info
  response property data/items/relationships/company/oneOf[CompanyV1]/relationships/crm_connections/items/relationships/crm_record/oneOf[CRMOrganizationV1]/relationships/crm_owner/oneOf[CRMUserV1]/attributes/first_name deprecated
- info
  response property data/items/relationships/company/oneOf[CompanyV1]/relationships/crm_group_connections/items/relationships/crm_connection/oneOf[CRMConnectionV1]/relationships/crm_record/oneOf[CRMContactV1]/relationships/crm_owner/oneOf[CRMUserV1]/attributes/first_name deprecated
- info
  response property data/items/relationships/company/oneOf[CompanyV1]/relationships/crm_group_connections/items/relationships/crm_connection/oneOf[CRMConnectionV1]/relationships/crm_record/oneOf[CRMLeadV1]/relationships/crm_owner/oneOf[CRMUserV1]/attributes/first_name deprecated
- info
  response property data/items/relationships/company/oneOf[CompanyV1]/relationships/crm_group_connections/items/relationships/crm_connection/oneOf[CRMConnectionV1]/relationships/crm_record/oneOf[CRMOrganizationV1]/attributes/zip_code deprecated
- info
  response property data/items/relationships/company/oneOf[CompanyV1]/relationships/crm_group_connections/items/relationships/crm_connection/oneOf[CRMConnectionV1]/relationships/crm_record/oneOf[CRMOrganizationV1]/relationships/crm_owner/oneOf[CRMUserV1]/attributes/first_name deprecated
- info
  response property data/items/relationships/company/oneOf[CompanyV1]/relationships/crm_suggestions/items/relationships/crm_record/oneOf[CRMContactV1]/relationships/crm_owner/oneOf[CRMUserV1]/attributes/first_name deprecated
- info
  response property data/items/relationships/company/oneOf[CompanyV1]/relationships/crm_suggestions/items/relationships/crm_record/oneOf[CRMLeadV1]/relationships/crm_owner/oneOf[CRMUserV1]/attributes/first_name deprecated
- info
  response property data/items/relationships/company/oneOf[CompanyV1]/relationships/crm_suggestions/items/relationships/crm_record/oneOf[CRMOrganizationV1]/attributes/zip_code deprecated
- info
  response property data/items/relationships/company/oneOf[CompanyV1]/relationships/crm_suggestions/items/relationships/crm_record/oneOf[CRMOrganizationV1]/relationships/crm_owner/oneOf[CRMUserV1]/attributes/first_name deprecated

Operation history (10 revisions)