Pages

Page analytics are exposed as separate paginated resources. Cursors are opaque; pass pagination.nextCursor back as cursor without editing it. Totals are not returned by default.

Endpoints

GET https://trackfox.app/api/v1/pages/top
GET https://trackfox.app/api/v1/pages/entry
GET https://trackfox.app/api/v1/pages/exit
GET https://trackfox.app/api/v1/pages/exit-links

Query Parameters

Parameter	Type	Required	Description
websiteId	string	Yes	The unique identifier of your website
period	string	No	Defaults to last30d
startDate	string	Only for period=custom	Custom period start date
endDate	string	Only for period=custom	Custom period end date
timezone	string	No	Defaults to UTC
limit	number	No	Defaults to 50, maximum 100
cursor	string	No	Opaque cursor from the previous response

Response

{
  "data": [
    {
      "path": "/pricing",
      "visitors": 120
    }
  ],
  "pagination": {
    "limit": 50,
    "hasMore": true,
    "nextCursor": "NEXT_CURSOR"
  }
}

/api/v1/pages/exit-links returns url instead of path.

{
  "data": [
    {
      "url": "https://example.com",
      "visitors": 18
    }
  ],
  "pagination": {
    "limit": 50,
    "hasMore": false,
    "nextCursor": null
  }
}

Examples

curl "https://trackfox.app/api/v1/pages/top?websiteId=site_123&period=last30d&limit=25" \
  -H "Authorization: Bearer tf_your_api_token_here"

curl "https://trackfox.app/api/v1/pages/top?websiteId=site_123&period=last30d&limit=25&cursor=NEXT_CURSOR" \
  -H "Authorization: Bearer tf_your_api_token_here"