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

# What drove a day

> One day broken down: the day's total for the metric, its normal level (the same baseline as /content/spikes), how many posts gained and how many were new that day, the top posts by gain and everyone else rolled up. `date` is required and must fall inside start_date..end_date. `lifetime_total` is the post's total at the end of that day. Shares are 0-1. Creator names follow your access to each creator's details. Live: new post readings show up on the next call.



## OpenAPI

````yaml GET /content/day_breakdown
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:
  /content/day_breakdown:
    get:
      summary: What drove a day
      description: >-
        One day broken down: the day's total for the metric, its normal level
        (the same baseline as /content/spikes), how many posts gained and how
        many were new that day, the top posts by gain and everyone else rolled
        up. `date` is required and must fall inside start_date..end_date.
        `lifetime_total` is the post's total at the end of that day. Shares are
        0-1. Creator names follow your access to each creator's details. Live:
        new post readings show up on the next call.
      parameters:
        - name: organization_id
          in: query
          required: false
          description: >-
            Read one of your child brands instead of the organization that owns
            the key. Any id that is not one of your brands answers 404.
          schema:
            type: integer
        - name: start_date
          in: query
          required: false
          description: 'First day, YYYY-MM-DD. Default: 29 days ago.'
          schema:
            type: string
            format: date
        - name: end_date
          in: query
          required: false
          description: 'Last day, YYYY-MM-DD. Default: today (UTC).'
          schema:
            type: string
            format: date
        - name: campaign_ids
          in: query
          required: false
          description: >-
            Comma separated campaign ids (from /content/filters). One id reads
            that campaign; several read their union, a post in two of them
            counting once. Every id must belong to your organization.
          schema:
            type: string
        - name: platform
          in: query
          required: false
          description: Only this platform.
          schema:
            type: string
            enum:
              - instagram
              - tik_tok
              - youtube
              - facebook
              - twitter
        - name: date
          in: query
          required: false
          description: The day, YYYY-MM-DD. Required.
          schema:
            type: string
            format: date
        - name: metric
          in: query
          required: false
          description: The metric. Default views.
          schema:
            type: string
            enum:
              - views
              - likes
              - comments
              - shares
              - saves
        - name: baseline_days
          in: query
          required: false
          description: Days in the baseline median, 3-60. Default 14.
          schema:
            type: integer
        - name: limit
          in: query
          required: false
          description: Top posts, 1-20. Default 5.
          schema:
            type: integer
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  data:
                    type: object
                    properties:
                      date:
                        type: string
                        format: date
                      metric:
                        type: string
                      total:
                        type: integer
                      baseline:
                        type: number
                      ratio:
                        type: number
                        nullable: true
                      posts_with_gain:
                        type: integer
                      new_posts:
                        type: integer
                        description: >-
                          Posts first tracked that day (their gain is their
                          lifetime total)
                      top:
                        type: array
                        items:
                          type: object
                          properties:
                            social_post_id:
                              type: string
                              description: platform:post id
                            platform:
                              type: string
                            user_id:
                              type: integer
                              nullable: true
                            creator_name:
                              type: string
                              nullable: true
                              description: >-
                                Shortened (first name, last initial) for
                                creators whose details you cannot see
                            avatar_url:
                              type: string
                              nullable: true
                            username:
                              type: string
                              nullable: true
                            thumbnail_url:
                              type: string
                              nullable: true
                              description: >-
                                A static image when the platform has one
                                (YouTube); otherwise null
                            post_url:
                              type: string
                              nullable: true
                            gain:
                              type: integer
                            share:
                              type: number
                            lifetime_total:
                              type: integer
                            posted_at:
                              type: string
                              format: date-time
                              nullable: true
                      others:
                        type: object
                        properties:
                          count:
                            type: integer
                          gain:
                            type: integer
                          share:
                            type: number
                  meta:
                    type: object
                    properties:
                      scope:
                        type: string
                        enum:
                          - family
                          - brand
                          - campaign
                        description: >-
                          family: your organization and its brands; brand: one
                          child brand; campaign: the campaign_ids
                      organization_id:
                        type: integer
                      campaign_ids:
                        type: array
                        items:
                          type: integer
                      platform:
                        type: string
                        nullable: true
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '404':
          description: >-
            `organization_id` isn't an active child brand of your organization,
            or the record doesn't exist
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '422':
          description: Invalid or missing params. `error` says which
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '429':
          description: >-
            Rate limited: 2 seconds between calls and an hourly cap per API key.
            See `Retry-After` and the `X-RateLimit-*` headers
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
components:
  schemas:
    ApiError:
      type: object
      properties:
        error:
          type: string
          description: What went wrong
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

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