> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sequenzy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Landing Page Stats

> Get visits, unique visits, clicks, subscribes, conversion rate, referrers, and a daily histogram

Mailchimp-style landing page analytics for one page. Default totals exclude
known crawlers. Preview URLs and the editor never count. Opening the public
URL while building the page does count.

`conversionRate` is subscribes divided by unique visits, as a percentage.
The histogram is daily; `period=all` returns all retained analytics and a
90-day chart. `dataAvailableFrom` identifies the beginning of that retained
coverage. Events from before analytics collection began are not backfilled,
and raw events expire after two years. Lifetime `viewCount` / `conversionCount`
on the page remain PostgreSQL compatibility counters for lists and
`get_landing_page`, so they may include earlier traffic.

## Request

<ParamField path="landingPageId" type="string" required>
  Landing page ID.
</ParamField>

<ParamField query="period" type="string">
  Time window: `7d`, `30d`, `90d`, or `all`. Defaults to `all`.
</ParamField>

<ParamField query="start" type="string">
  Custom range start as an ISO 8601 timestamp. Provide `end` too. Maximum range
  is 365 days.
</ParamField>

<ParamField query="end" type="string">
  Custom range end as an ISO 8601 timestamp. Provide `start` too.
</ParamField>

<ParamField query="includeBots" type="boolean">
  Include known crawlers in visits, unique visits, clicks, referrers, and the
  histogram. Crawler hits are always returned separately as `botVisits`.
</ParamField>

```bash theme={null}
curl "https://api.sequenzy.com/api/v1/landing-pages/lp_abc123/stats?period=30d" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Responses

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "stats": {
      "landingPageId": "lp_abc123",
      "period": "30d",
      "start": "2026-07-31T00:00:00.000Z",
      "end": "2026-08-29T12:00:00.000Z",
      "dataAvailableFrom": "2026-08-29T00:00:00.000Z",
      "visits": 48,
      "uniqueVisits": 31,
      "clicks": 12,
      "subscribes": 6,
      "conversionRate": 19.35,
      "botVisits": 4,
      "lifetimeViewCount": 52,
      "lifetimeConversionCount": 6,
      "histogram": [
        {
          "date": "2026-08-28",
          "visits": 9,
          "uniqueVisits": 7,
          "clicks": 3,
          "subscribes": 1
        }
      ],
      "referrers": [
        { "name": "twitter.com", "visits": 20, "uniqueVisits": 14 },
        { "name": "direct", "visits": 11, "uniqueVisits": 9 }
      ],
      "sources": [
        { "name": "twitter", "visits": 18, "uniqueVisits": 12 },
        { "name": "direct", "visits": 13, "uniqueVisits": 10 }
      ],
      "countsInclude": "Published public page loads retained from dataAvailableFrom. Known crawlers are excluded from visits, unique visits, and clicks. Preview URLs and the editor do not count. Opening the public URL while building the page does count. Lifetime page counters may include earlier traffic."
    }
  }
  ```

  ```json 400 theme={null}
  {
    "success": false,
    "error": "Landing page stats period must be 7d, 30d, 90d, or all."
  }
  ```

  ```json 401 theme={null}
  {
    "success": false,
    "error": "Unauthorized"
  }
  ```

  ```json 404 theme={null}
  {
    "success": false,
    "error": "Landing page not found"
  }
  ```
</ResponseExample>