---
title: "Fetch date statistics for a website"
method: POST
path: "/v1/analytics/website/date"
tags: ["Public API"]
---

# Fetch date statistics for a website

`POST /v1/analytics/website/date`

## Request

- Base URL: `https://api.foudroyer.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.foudroyer.com/v1/analytics/website/date`
- Auth: HTTP bearer

Retrieves date-based analytics statistics for a specific website.

## Request body

- GetStatsDto
  - `websiteId` string, required: The ID of the website to fetch analytics for
  - `filter` FilterEntity, required
    - `source` string: Filter by source
    - `query` string: Filter by search query
    - `country` string: Filter by country code
    - `device` 'desktop' | 'mobile' | 'tablet': Filter by device type
    - `page` string: Filter by page URL
    - `from` string, date-time, required: Start date for the analytics period
    - `to` string, date-time, required: End date for the analytics period
  - `orderBy` 'clicks' | 'click_through_rate' | 'impressions' | 'position' | 'date': Order by field for sorting results

## Response `200`

Analytics statistics including date stats and global metrics

- AnalyticsFetchDateStatsResponseDto
  - `global` GlobalStatsDto, required
    - `clicks` number, required: Total clicks
    - `previous_clicks` number, required: Total clicks from previous period
    - `impressions` number, required: Total impressions
    - `previous_impressions` number, required: Total impressions from previous period
    - `position` number, required: Average position
    - `previous_position` number, required: Average position from previous period
    - `click_through_rate` number, required: Click-through rate percentage
    - `previous_click_through_rate` number, required: Click-through rate from previous period
  - `date` DateStatItemDto[], required
    - `clicks` number, required: Number of clicks for this date
    - `impressions` number, required: Number of impressions for this date
    - `position` number, required: Average position for this date
    - `click_through_rate` number, required: Click-through rate percentage
    - `date` object, required: Date of the stat
  - `sources` SourceStatItemDto[], required
    - `source` string, required: Source name
    - `clicks` number, required: Number of clicks
    - `impressions` number, required: Number of impressions
    - `position` number, required: Average position
    - `click_through_rate` number, required: Click-through rate percentage
  - `devices` DateStatItemDto[], required: Empty array
    - `clicks` number, required: Number of clicks for this date
    - `impressions` number, required: Number of impressions for this date
    - `position` number, required: Average position for this date
    - `click_through_rate` number, required: Click-through rate percentage
    - `date` object, required: Date of the stat
  - `query` DateStatItemDto[], required: Empty array
    - `clicks` number, required: Number of clicks for this date
    - `impressions` number, required: Number of impressions for this date
    - `position` number, required: Average position for this date
    - `click_through_rate` number, required: Click-through rate percentage
    - `date` object, required: Date of the stat
  - `countries` DateStatItemDto[], required: Empty array
    - `clicks` number, required: Number of clicks for this date
    - `impressions` number, required: Number of impressions for this date
    - `position` number, required: Average position for this date
    - `click_through_rate` number, required: Click-through rate percentage
    - `date` object, required: Date of the stat
  - `pages` DateStatItemDto[], required: Empty array
    - `clicks` number, required: Number of clicks for this date
    - `impressions` number, required: Number of impressions for this date
    - `position` number, required: Average position for this date
    - `click_through_rate` number, required: Click-through rate percentage
    - `date` object, required: Date of the stat

---

[API](https://skmtc.dev/foudroyer/apis/foudroyer-api.md) - [All operations](https://skmtc.dev/foudroyer/apis/foudroyer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/foudroyer/apis/foudroyer-api/revisions/5b917c67e013?raw)