v8

latestOpenAPI 3.0.3raw.githubusercontent.com2026-05-2526602.8 MB
Statistics

Get Profile Visitors

Get the number of profile visitors for a given period.

get/api/{account}/statistics/reach/profile-visitors

Query parameters

start_datestring required

The start date for the period

Example:2025-01-01 00:00:00

The start date for the period

end_datestring required

The end date for the period.

Example:2025-03-31 23:59:59

The end date for the period.

type'total' | 'users' | 'guests' nullable

Filter all / users / guests

Example:total

Filter all / users / guests

filter'chart' | 'topCountries' nullable

Optionally, filter the results by chart or topCountries. See example responses.

Example:chart

Optionally, filter the results by chart or topCountries. See example responses.

limitinteger nullable

Number of results to return

Example:10

Number of results to return

Response

OR
OR

Example response

{
  "data": {
    "isAvailable": true,
    "topCountries": {
      "hasMore": true,
      "totals": {
        "total": 123,
        "guests": "123",
        "users": "123",
        "subscribers": 123
      },
      "rows": [
        {
          "rank": 1,
          "countryName": "Australia",
          "countryCode": "AU",
          "viewsCount": {
            "total": 123,
            "guests": 123,
            "users": 123,
            "subscribers": 123
          }
        },
        {
          "rank": 2,
          "countryName": "United States",
          "countryCode": "US",
          "viewsCount": {
            "total": 123,
            "guests": 123,
            "users": 123,
            "subscribers": 123
          }
        },
        {
          "rank": 3,
          "countryName": "Spain",
          "countryCode": "ES",
          "viewsCount": {
            "total": 123,
            "guests": 123,
            "users": 123,
            "subscribers": 123
          }
        },
        {
          "rank": 4,
          "countryName": "United Kingdom",
          "countryCode": "GB",
          "viewsCount": {
            "total": 123,
            "guests": 123,
            "users": 123,
            "subscribers": 123
          }
        },
        {
          "rank": 5,
          "countryName": "Austria",
          "countryCode": "AT",
          "viewsCount": {
            "total": 123,
            "guests": 123,
            "users": 123,
            "subscribers": 123
          }
        },
        {
          "rank": 6,
          "countryName": "Norway",
          "countryCode": "NO",
          "viewsCount": {
            "total": 21,
            "guests": 21,
            "users": 0,
            "subscribers": 0
          }
        },
        {
          "rank": 7,
          "countryName": "Singapore",
          "countryCode": "SG",
          "viewsCount": {
            "total": 123,
            "guests": 123,
            "users": 123,
            "subscribers": 123
          }
        },
        {
          "rank": 8,
          "countryName": "Germany",
          "countryCode": "DE",
          "viewsCount": {
            "total": 123,
            "guests": 123,
            "users": 123,
            "subscribers": 123
          }
        },
        {
          "rank": 9,
          "countryName": "Mexico",
          "countryCode": "MX",
          "viewsCount": {
            "total": 123,
            "guests": 123,
            "users": 123,
            "subscribers": 123
          }
        },
        {
          "rank": 10,
          "countryName": "Israel",
          "countryCode": "IL",
          "viewsCount": {
            "total": 123,
            "guests": 123,
            "users": 123,
            "subscribers": 123
          }
        },
        {
          "rank": 11,
          "countryName": "Others",
          "countryCode": "",
          "viewsCount": {
            "total": 123,
            "guests": 123,
            "users": 123,
            "subscribers": 123
          }
        }
      ]
    },
    "topDurationUsers": {
      "totals": {
        "total": 123,
        "guests": "123",
        "users": "123",
        "subscribers": 123
      }
    },
    "chart": {
      "visitors": [
        {
          "date": "2025-01-01T00:00:00+00:00",
          "count": 123
        }
      ],
      "duration": [
        {
          "date": "2025-01-01T00:00:00+00:00",
          "count": 123
        }
      ]
    },
    "total": {
      "current": "123",
      "delta": 12.3
    },
    "hasStats": true
  },
  "_meta": {
    "_credits": {
      "used": 1,
      "balance": 999999818,
      "note": "Always"
    },
    "_cache": {
      "is_cached": false,
      "note": "Cache disabled for this endpoint"
    },
    "_rate_limits": {
      "limit_minute": 1000,
      "limit_day": 50000,
      "remaining_minute": 999,
      "remaining_day": 49963
    }
  }
}