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

# Get Snapshots

> Retrieves time-series data for content engagement metrics within a specified date range

Retrieves time-series data for content engagement metrics within a specified date range.

## Response Fields

Each snapshot object contains the following fields:

| Field               | Type         | Description                                           |
| ------------------- | ------------ | ----------------------------------------------------- |
| `date`              | String       | The date for this snapshot in YYYY-MM-DD format       |
| `total_views`       | Integer      | Total number of views for all content on this date    |
| `total_likes`       | Integer      | Total number of likes for all content on this date    |
| `total_comments`    | Integer      | Total number of comments for all content on this date |
| `total_shares`      | Integer      | Total number of shares for all content on this date   |
| `total_saves`       | Integer      | Total number of saves for all content on this date    |
| `total_posts_count` | Integer      | Total number of posts created on this date            |
| `user_content_ids`  | Array        | List of user content IDs associated with this date    |
| `organization_id`   | Integer/null | Organization ID if applicable                         |

## Request Parameters

| Parameter     | Type    | Description                                                                                                                                  | Required | Default               |
| ------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------- | -------- | --------------------- |
| `start_date`  | String  | Start date in MM/DD/YYYY format                                                                                                              | Yes      | Current date - 7 days |
| `end_date`    | String  | End date in MM/DD/YYYY format                                                                                                                | Yes      | Current date          |
| `limit`       | Integer | Limit the number of results. Default is 4. Recommended is 20. Set to 10,000 to get all data.                                                 | No       | 4                     |
| `campaign_id` | Integer | Filter snapshots by specific campaign ID. You can get campaign IDs from the [Get Campaigns](/api-reference/endpoint/get-campaigns) endpoint. | No       | -                     |

## Request Example

```bash theme={null}
curl -X GET "https://api.growi.io/api/public/v1/stats/snapshots?start_date=10/01/2025&end_date=11/14/2025" \
     -H "Authorization: Bearer YOUR_PUBLIC_API_KEY" \
     -H "Content-Type: application/json"
```

## Response Example

```json theme={null}
{
  "success": true,
  "data": {
    "snapshots": [
      {
        "date": "2025-05-12",
        "total_views": 506174,
        "total_likes": 15382,
        "total_comments": 476,
        "total_shares": 2355,
        "total_saves": 8924,
        "organization_id": null,
        "user_content_ids": [12345, 12346, 12347],
        "total_posts_count": 3
      },
      {
        "date": "2025-05-13",
        "total_views": 638747,
        "total_likes": 20915,
        "total_comments": 581,
        "total_shares": 4037,
        "total_saves": 11254,
        "organization_id": null,
        "user_content_ids": [12348, 12349],
        "total_posts_count": 2
      },
      {
        "date": "2025-05-14",
        "total_views": 1002978,
        "total_likes": 35385,
        "total_comments": 789,
        "total_shares": 9539,
        "total_saves": 19847,
        "organization_id": null,
        "user_content_ids": [12350, 12351, 12352, 12353],
        "total_posts_count": 4
      }
      // Additional daily snapshots...
    ]
  }
}
```


## OpenAPI

````yaml GET /stats/snapshots
openapi: 3.0.1
info:
  title: Growi API
  description: >-
    API documentation for Growi platform, showcasing the public tracking event
    endpoint
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.growi.io/api/public/v1
security:
  - bearerAuth: []
paths:
  /stats/snapshots:
    get:
      description: >-
        Retrieves time-series data for content engagement metrics within a
        specified date range
      parameters:
        - name: start_date
          in: query
          required: true
          example: 10/01/2025
          schema:
            type: string
            format: date
            default: 10/01/2025
          description: Start date in MM/DD/YYYY format
        - name: end_date
          in: query
          required: true
          example: 11/14/2025
          schema:
            type: string
            format: date
            default: 11/14/2025
          description: End date in MM/DD/YYYY format
        - name: limit
          in: query
          required: false
          example: 4
          schema:
            type: integer
            default: 4
          description: >-
            Limit the number of results. Default is 4. Recommended is 20. Set to
            10,000 to get all data.
        - name: campaign_id
          in: query
          required: false
          example: 16425
          schema:
            type: integer
          description: >-
            Filter snapshots by specific campaign ID. You can get campaign IDs
            from the Get Campaigns endpoint.
      responses:
        '200':
          description: Snapshots retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    description: Snapshots data
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      required:
        - error
        - message
      type: object
      properties:
        error:
          type: string
        message:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````