Get the List of Visitors 

Description

You can use this API to fetch the list of the visitors visiting your website and their details for the given time in Milliseconds.

Note: For the API to work, you should enable the Basic visitor information option in the Settings > Portal Settings > API Permissions

HTTP Method - GET

Query Parameters

  • limit : The number of visitors you would like to fetch at a time by hitting the API once. By default the limit is set to 200, if you fail to set the limit then the default limit will be set to fetch the data. You can use the limit param to set the limit below the default limit and not above, ie., you can set the limit within 200, but cannot set above 200. 
  • prev_key : To fetch the visitor data available before the specified time in Milliseconds. When you use the API for the first time, you should mention the Start time, after that you should use the last response prev_key of the previous API to fetch the prior data. 

(or)

  • next_key : To fetch the visitor data after the given time in Milliseconds. When you use the API for the first time, you should mention the start time, after that you should use the last response next_key of the previous API to fetch the data thereafter. 

Note: You can either use prev_key or next_key to fetch the data at a time, you cannot use both the keys together. 

OAuth Scope:

visitors.READ

URL:

Copiedhttps://{[zohosalesiq_server_uri](https://www.zoho.com/salesiq/help/developer-section/rest-api-v2.html)}/api/v3/{screenname}/visitors/

Example

Copiedhttps://salesiq.zoho.com/api/v3/zylker/visitors?limit=1&next_key=1548845978127

Sample Response

Copied{
  "url": "/api/v3/visitors",
  "object": "list",
  "data": [
    {
      "name": "Tricia",
      "id": "9faf3023-5e8d-484c-8996-01861e39",
      "country": "United States",
      "lead_score": 20,
      "first_accessed_time": "1548764040423",
      "visit_source": "Direct",
      "visit_count": 2,
      "last_accessed_time": "1548964730161",
      "phone_number":"0065434567876",
      "email_id": "tricia@zylker.com",
      "crm_infos": [
        {
          "contact_id": "407557000000312012",
          "service_name": "Zylker"
        },
        {
          "service_name": "Zylkersales",
          "lead_id": "00Q7F00000UAE"
        }
      ]
    }
  ],
  "next_key": "1548964733461",
  "prev_key": "1548845978237"
}