Get analytics overview for all platforms

get/v1/social/analytics

Get analytics overview for all platforms

Request

Parameters

Name	In	Type	Description
days	query	string	No description

Responses

200No description

Schema

Schema Structure

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "data": {
      "type": "object",
      "properties": {
        "period_days": {},
        "total_posts": {
          "type": "integer",
          "minimum": 0
        },
        "posts_by_platform": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "integer"
              },
              "social_post_id": {
                "type": "string"
              },
              "social_account_id": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "platform": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "platform_post_id": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "platform_url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "platform_response": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {}
              },
              "error_message": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "error_details": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {}
              },
              "retry_count": {
                "type": "integer"
              },
              "likes": {
                "type": "integer"
              },
              "comments": {
                "type": "integer"
              },
              "shares": {
                "type": "integer"
              },
              "views": {
                "type": "integer"
              },
              "clicks": {
                "type": "integer"
              },
              "engagement_rate": {
                "type": "string"
              },
              "published_at": {
                "type": [
                  "string",
                  "null"
                ],
                "format": "date-time"
              },
              "last_analytics_fetch": {
                "type": [
                  "string",
                  "null"
                ],
                "format": "date-time"
              },
              "created_at": {
                "type": [
                  "string",
                  "null"
                ],
                "format": "date-time"
              },
              "updated_at": {
                "type": [
                  "string",
                  "null"
                ],
                "format": "date-time"
              }
            },
            "required": [
              "id",
              "social_post_id",
              "social_account_id",
              "platform",
              "status",
              "platform_post_id",
              "platform_url",
              "platform_response",
              "error_message",
              "error_details",
              "retry_count",
              "likes",
              "comments",
              "shares",
              "views",
              "clicks",
              "engagement_rate",
              "published_at",
              "last_analytics_fetch",
              "created_at",
              "updated_at"
            ],
            "title": "SocialPostResult"
          }
        },
        "total_engagement": {
          "type": "object",
          "properties": {
            "likes": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer",
                  "enum": [
                    0
                  ]
                }
              ]
            },
            "comments": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer",
                  "enum": [
                    0
                  ]
                }
              ]
            },
            "shares": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer",
                  "enum": [
                    0
                  ]
                }
              ]
            },
            "views": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer",
                  "enum": [
                    0
                  ]
                }
              ]
            }
          },
          "required": [
            "likes",
            "comments",
            "shares",
            "views"
          ]
        },
        "top_posts": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "content": {
                "type": "string"
              },
              "platforms": {
                "type": "string"
              },
              "total_engagement": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "integer",
                    "enum": [
                      0
                    ]
                  }
                ]
              },
              "published_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "content",
              "platforms",
              "total_engagement",
              "published_at"
            ]
          }
        }
      },
      "required": [
        "period_days",
        "total_posts",
        "posts_by_platform",
        "total_engagement",
        "top_posts"
      ]
    }
  },
  "required": [
    "success",
    "data"
  ]
}