> ## 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 filters

> Campaigns, platforms, content types and creators you can filter the old Home stats by.

> [!WARNING]
>
> **Deprecated.** This is one of the old Home stats endpoints. It still works, but new
> integrations should use the faster endpoints. Use [Content filters](https://growi.mintlify.site/api-reference/endpoint/content/filters.md) (`GET /content/filters`).
> Responses carry `Deprecation` and `Link` headers.
> It takes `MM/DD/YYYY` dates; the new endpoints take ISO 8601 (`YYYY-MM-DD`). See [deprecations](https://growi.mintlify.site/api-reference/changelog.md#deprecations).

Retrieves available filters for your organization within a specified date range.

## Request parameters

| Parameter | Type | Description | Required |
| - | - | - | - |
| `start_date` | String | Start date in MM/DD/YYYY format | Yes |
| `end_date` | String | End date in MM/DD/YYYY format | Yes |
| `limit` | Integer | Limit the number of results. Default is 4. Recommended is 20. Set to 10,000 to get all data. | No |

## Request example

```bash theme={"dark"}
curl -X GET "https://api.growi.io/api/public/v1/stats/filters?start_date=01/01/2023&end_date=01/31/2023" \
     -H "Authorization: Bearer YOUR_PUBLIC_API_KEY" \
     -H "Content-Type: application/json"
```

## Response example

```json theme={"dark"}
{
  "success": true,
  "data": {
    "campaigns": [
      {
        "campaign_id": 123,
        "name": "Summer Collection",
        "status": "active",
        "start_date": "2023-01-01",
        "end_date": "2023-01-31"
      },
      {
        "campaign_id": 124,
        "name": "Back to School",
        "status": "planned",
        "start_date": "2023-02-01",
        "end_date": "2023-02-28"
      }
    ],
    "platforms": [
      "instagram",
      "tiktok",
      "youtube",
      "facebook",
      "twitter"
    ],
    "content_types": [
      "video",
      "image",
      "carousel",
      "story",
      "reel"
    ],
    "creators": [
      {
        "creator_id": 1001,
        "name": "Jane Smith",
        "username": "@janesmith"
      },
      {
        "creator_id": 1002,
        "name": "John Doe",
        "username": "@johndoe"
      }
    ],
    "total_filters": 4
  }
}
```

```bash cURL theme={"dark"}
curl -X GET "https://api.growi.io/api/public/v1/stats/filters?start_date=01/01/2023&end_date=01/31/2023" \
     -H "Authorization: Bearer YOUR_PUBLIC_API_KEY" \
     -H "Content-Type: application/json"
```

```json 200 theme={"dark"}
{
  "success": true,
  "data": {
    "campaigns": [
      {
        "campaign_id": 123,
        "name": "Summer Collection",
        "status": "active",
        "start_date": "2023-01-01",
        "end_date": "2023-01-31"
      },
      {
        "campaign_id": 124,
        "name": "Back to School",
        "status": "planned",
        "start_date": "2023-02-01",
        "end_date": "2023-02-28"
      }
    ],
    "platforms": [
      "instagram",
      "tiktok",
      "youtube",
      "facebook",
      "twitter"
    ],
    "content_types": [
      "video",
      "image",
      "carousel",
      "story",
      "reel"
    ],
    "creators": [
      {
        "creator_id": 1001,
        "name": "Jane Smith",
        "username": "@janesmith"
      },
      {
        "creator_id": 1002,
        "name": "John Doe",
        "username": "@johndoe"
      }
    ],
    "total_filters": 4
  }
}
```


## OpenAPI

````yaml GET /stats/filters
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/filters:
    get:
      description: >-
        Campaigns, platforms, content types and creators you can filter the old
        Home stats by.
      parameters:
        - name: start_date
          in: query
          required: true
          schema:
            type: string
          description: Start date (MM/DD/YYYY)
          example: 01/01/2026
        - name: end_date
          in: query
          required: true
          schema:
            type: string
          description: End date (MM/DD/YYYY)
          example: 01/31/2026
        - name: organization_id
          in: query
          required: false
          schema:
            type: integer
          description: A child brand of your organization
        - name: campaign_id
          in: query
          required: false
          schema:
            type: string
          description: One campaign id or a comma-separated list
      responses:
        '200':
          description: Available filters
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  data:
                    type: object
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
        '429':
          description: Rate limited. See Retry-After
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
      deprecated: true
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.