cURL
curl --request GET \
--url https://api.growi.io/api/public/v1/stats/user_contents \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.growi.io/api/public/v1/stats/user_contents"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.growi.io/api/public/v1/stats/user_contents', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.growi.io/api/public/v1/stats/user_contents",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.growi.io/api/public/v1/stats/user_contents"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.growi.io/api/public/v1/stats/user_contents")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.growi.io/api/public/v1/stats/user_contents")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {}
}{
"error": "<string>",
"message": "<string>"
}Stats API
Get User Contents
Retrieves all user content creation data within a date range
GET
/
stats
/
user_contents
cURL
curl --request GET \
--url https://api.growi.io/api/public/v1/stats/user_contents \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.growi.io/api/public/v1/stats/user_contents"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.growi.io/api/public/v1/stats/user_contents', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.growi.io/api/public/v1/stats/user_contents",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.growi.io/api/public/v1/stats/user_contents"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.growi.io/api/public/v1/stats/user_contents")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.growi.io/api/public/v1/stats/user_contents")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {}
}{
"error": "<string>",
"message": "<string>"
}Retrieves all user content creation data within a specified date range.
To include all-time views for each post, add
To sort results by posted date (newest first):
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 |
page | Integer | Page number for pagination. Default is 1. | No |
per_page | Integer | Number of results per page. Default is 40. Maximum is 100. | No |
include_all_time_views | Boolean | Include the post’s current all-time views in the response. Default is false. | No |
posted_at_sort | String | Sort results by posted date. Valid values: asc (oldest first) or desc (newest first). Case-insensitive. If not provided or invalid, no sorting is applied. | No |
Request Example
curl -X GET "https://api.growi.io/api/public/v1/stats/user_contents?start_date=01/01/2023&end_date=01/31/2023&limit=5&page=1&per_page=20" \
-H "Authorization: Bearer YOUR_PUBLIC_API_KEY" \
-H "Content-Type: application/json"
include_all_time_views=true:
curl -X GET "https://api.growi.io/api/public/v1/stats/user_contents?start_date=01/01/2023&end_date=01/31/2023&include_all_time_views=true" \
-H "Authorization: Bearer YOUR_PUBLIC_API_KEY" \
-H "Content-Type: application/json"
curl -X GET "https://api.growi.io/api/public/v1/stats/user_contents?start_date=01/01/2023&end_date=01/31/2023&posted_at_sort=desc" \
-H "Authorization: Bearer YOUR_PUBLIC_API_KEY" \
-H "Content-Type: application/json"
Sorting Behavior
Theposted_at_sort parameter sorts results by the content’s posted date (create_time):
asc- Oldest posts firstdesc- Newest posts first
posted_at_sort=desc with limit=10:
- Page 1 shows the 10 newest posts
- Page 2 shows the next 10 newest posts
- And so on…
Response Example
{
"success": true,
"data": {
"user_contents": [
{
"create_time": 1750182815,
"platform": "tik_tok",
"connected_account_id": 821801,
"username": "random_user",
"profile_share_url": "https://www.tiktok.com/@random_user",
"date": "Jun 17",
"sorted_dates": [
"Jan 01",
"Jan 02",
"Jan 03",
"Jan 04",
"Jan 05",
"Jan 06",
"Jan 07",
"Jan 08",
"Jan 09",
"Jan 10",
"Jan 11",
"Jan 12",
"Jan 13",
"Jan 14",
"Jan 15",
"Jan 16",
"Jan 17",
"Jan 18",
"Jan 19",
"Jan 20",
"Jan 21",
"Jan 22",
"Jan 23",
"Jan 24",
"Jan 25",
"Jan 26",
"Jan 27",
"Jan 28",
"Jan 29",
"Jan 30",
"Jan 31",
"Feb 01",
"Feb 02",
"Feb 03",
"Feb 04",
"Feb 05",
"Feb 06",
"Feb 07",
"Feb 08",
"Feb 09",
"Feb 10",
"Feb 11",
"Feb 12",
"Feb 13",
"Feb 14",
"Feb 15",
"Feb 16",
"Feb 17",
"Feb 18",
"Feb 19",
"Feb 20",
"Feb 21",
"Feb 22",
"Feb 23",
"Feb 24",
"Feb 25",
"Feb 26",
"Feb 27",
"Feb 28",
"Mar 01",
"Mar 02",
"Mar 03",
"Mar 04",
"Mar 05",
"Mar 06",
"Mar 07",
"Mar 08",
"Mar 09",
"Mar 10",
"Mar 11",
"Mar 12",
"Mar 13",
"Mar 14",
"Mar 15",
"Mar 16",
"Mar 17",
"Mar 18",
"Mar 19",
"Mar 20",
"Mar 21",
"Mar 22",
"Mar 23",
"Mar 24",
"Mar 25",
"Mar 26",
"Mar 27",
"Mar 28",
"Mar 29",
"Mar 30",
"Mar 31",
"Apr 01",
"Apr 02",
"Apr 03",
"Apr 04",
"Apr 05",
"Apr 06",
"Apr 07",
"Apr 08",
"Apr 09",
"Apr 10",
"Apr 11",
"Apr 12",
"Apr 13",
"Apr 14",
"Apr 15",
"Apr 16",
"Apr 17",
"Apr 18",
"Apr 19",
"Apr 20",
"Apr 21",
"Apr 22",
"Apr 23",
"Apr 24",
"Apr 25",
"Apr 26",
"Apr 27",
"Apr 28",
"Apr 29",
"Apr 30",
"May 01",
"May 02",
"May 03",
"May 04",
"May 05",
"May 06",
"May 07",
"May 08",
"May 09",
"May 10",
"May 11",
"May 12",
"May 13",
"May 14",
"May 15",
"May 16",
"May 17",
"May 18",
"May 19",
"May 20",
"May 21",
"May 22",
"May 23",
"May 24",
"May 25",
"May 26",
"May 27",
"May 28",
"May 29",
"May 30",
"May 31",
"Jun 01",
"Jun 02",
"Jun 03",
"Jun 04",
"Jun 05",
"Jun 06",
"Jun 07",
"Jun 08",
"Jun 09",
"Jun 10",
"Jun 11",
"Jun 12",
"Jun 13",
"Jun 14",
"Jun 15",
"Jun 16",
"Jun 17",
"Jun 18",
"Jun 19",
"Jun 20",
"Jun 21",
"Jun 22",
"Jun 23",
"Jun 24",
"Jun 25",
"Jun 26",
"Jun 27",
"Jun 28",
"Jun 29",
"Jun 30",
"Jul 01",
"Jul 02",
"Jul 03",
"Jul 04",
"Jul 05",
"Jul 06",
"Jul 07",
"Jul 08",
"Jul 09",
"Jul 10",
"Jul 11",
"Jul 12",
"Jul 13",
"Jul 14",
"Jul 15",
"Jul 16",
"Jul 17",
"Jul 18",
"Jul 19",
"Jul 20",
"Jul 21",
"Jul 22",
"Jul 23",
"Jul 24",
"Jul 25",
"Jul 26",
"Jul 27",
"Jul 28",
"Jul 29",
"Jul 30",
"Jul 31",
"Aug 01",
"Aug 02",
"Aug 03",
"Aug 04",
"Aug 05",
"Aug 06",
"Aug 07",
"Aug 08",
"Aug 09",
"Aug 10",
"Aug 11",
"Aug 12",
"Aug 13",
"Aug 14",
"Aug 15",
"Aug 16",
"Aug 17",
"Aug 18",
"Aug 19",
"Aug 20",
"Aug 21",
"Aug 22",
"Aug 23",
"Aug 24",
"Aug 25",
"Aug 26",
"Aug 27",
"Aug 28",
"Aug 29",
"Aug 30",
"Aug 31",
"Sep 01",
"Sep 02",
"Sep 03",
"Sep 04",
"Sep 05",
"Sep 06",
"Sep 07",
"Sep 08",
"Sep 09",
"Sep 10",
"Sep 11",
"Sep 12",
"Sep 13",
"Sep 14",
"Sep 15",
"Sep 16",
"Sep 17",
"Sep 18",
"Sep 19",
"Sep 20",
"Sep 21",
"Sep 22",
"Sep 23",
"Sep 24",
"Sep 25"
],
"total_views": 5,
"share_url": "https://www.tiktok.com/@chulu56578/video/7516977905713417503"
},
{
"create_time": 1750350254,
"platform": "tik_tok",
"connected_account_id": 34615,
"username": "kyliejenner",
"profile_share_url": "https://www.tiktok.com/@kyliejenner",
"date": "Jun 19",
"sorted_dates": [
"Jan 01",
"Jan 02",
"Jan 03",
"Jan 04",
"Jan 05",
"Jan 06",
"Jan 07",
"Jan 08",
"Jan 09",
"Jan 10",
"Jan 11",
"Jan 12",
"Jan 13",
"Jan 14",
"Jan 15",
"Jan 16",
"Jan 17",
"Jan 18",
"Jan 19",
"Jan 20",
"Jan 21",
"Jan 22",
"Jan 23",
"Jan 24",
"Jan 25",
"Jan 26",
"Jan 27",
"Jan 28",
"Jan 29",
"Jan 30",
"Jan 31",
"Feb 01",
"Feb 02",
"Feb 03",
"Feb 04",
"Feb 05",
"Feb 06",
"Feb 07",
"Feb 08",
"Feb 09",
"Feb 10",
"Feb 11",
"Feb 12",
"Feb 13",
"Feb 14",
"Feb 15",
"Feb 16",
"Feb 17",
"Feb 18",
"Feb 19",
"Feb 20",
"Feb 21",
"Feb 22",
"Feb 23",
"Feb 24",
"Feb 25",
"Feb 26",
"Feb 27",
"Feb 28",
"Mar 01",
"Mar 02",
"Mar 03",
"Mar 04",
"Mar 05",
"Mar 06",
"Mar 07",
"Mar 08",
"Mar 09",
"Mar 10",
"Mar 11",
"Mar 12",
"Mar 13",
"Mar 14",
"Mar 15",
"Mar 16",
"Mar 17",
"Mar 18",
"Mar 19",
"Mar 20",
"Mar 21",
"Mar 22",
"Mar 23",
"Mar 24",
"Mar 25",
"Mar 26",
"Mar 27",
"Mar 28",
"Mar 29",
"Mar 30",
"Mar 31",
"Apr 01",
"Apr 02",
"Apr 03",
"Apr 04",
"Apr 05",
"Apr 06",
"Apr 07",
"Apr 08",
"Apr 09",
"Apr 10",
"Apr 11",
"Apr 12",
"Apr 13",
"Apr 14",
"Apr 15",
"Apr 16",
"Apr 17",
"Apr 18",
"Apr 19",
"Apr 20",
"Apr 21",
"Apr 22",
"Apr 23",
"Apr 24",
"Apr 25",
"Apr 26",
"Apr 27",
"Apr 28",
"Apr 29",
"Apr 30",
"May 01",
"May 02",
"May 03",
"May 04",
"May 05",
"May 06",
"May 07",
"May 08",
"May 09",
"May 10",
"May 11",
"May 12",
"May 13",
"May 14",
"May 15",
"May 16",
"May 17",
"May 18",
"May 19",
"May 20",
"May 21",
"May 22",
"May 23",
"May 24",
"May 25",
"May 26",
"May 27",
"May 28",
"May 29",
"May 30",
"May 31",
"Jun 01",
"Jun 02",
"Jun 03",
"Jun 04",
"Jun 05",
"Jun 06",
"Jun 07",
"Jun 08",
"Jun 09",
"Jun 10",
"Jun 11",
"Jun 12",
"Jun 13",
"Jun 14",
"Jun 15",
"Jun 16",
"Jun 17",
"Jun 18",
"Jun 19",
"Jun 20",
"Jun 21",
"Jun 22",
"Jun 23",
"Jun 24",
"Jun 25",
"Jun 26",
"Jun 27",
"Jun 28",
"Jun 29",
"Jun 30",
"Jul 01",
"Jul 02",
"Jul 03",
"Jul 04",
"Jul 05",
"Jul 06",
"Jul 07",
"Jul 08",
"Jul 09",
"Jul 10",
"Jul 11",
"Jul 12",
"Jul 13",
"Jul 14",
"Jul 15",
"Jul 16",
"Jul 17",
"Jul 18",
"Jul 19",
"Jul 20",
"Jul 21",
"Jul 22",
"Jul 23",
"Jul 24",
"Jul 25",
"Jul 26",
"Jul 27",
"Jul 28",
"Jul 29",
"Jul 30",
"Jul 31",
"Aug 01",
"Aug 02",
"Aug 03",
"Aug 04",
"Aug 05",
"Aug 06",
"Aug 07",
"Aug 08",
"Aug 09",
"Aug 10",
"Aug 11",
"Aug 12",
"Aug 13",
"Aug 14",
"Aug 15",
"Aug 16",
"Aug 17",
"Aug 18",
"Aug 19",
"Aug 20",
"Aug 21",
"Aug 22",
"Aug 23",
"Aug 24",
"Aug 25",
"Aug 26",
"Aug 27",
"Aug 28",
"Aug 29",
"Aug 30",
"Aug 31",
"Sep 01",
"Sep 02",
"Sep 03",
"Sep 04",
"Sep 05",
"Sep 06",
"Sep 07",
"Sep 08",
"Sep 09",
"Sep 10",
"Sep 11",
"Sep 12",
"Sep 13",
"Sep 14",
"Sep 15",
"Sep 16",
"Sep 17",
"Sep 18",
"Sep 19",
"Sep 20",
"Sep 21",
"Sep 22",
"Sep 23",
"Sep 24",
"Sep 25"
],
"total_views": 19989943,
"share_url": "https://www.tiktok.com/@kyliejenner/video/7517696966378278175"
},
{
"create_time": 1753459065,
"platform": "instagram",
"connected_account_id": 15670,
"username": "growi.io",
"profile_share_url": "https://www.instagram.com/growi.io/",
"date": "Jul 25",
"sorted_dates": [
"Jan 01",
"Jan 02",
"Jan 03",
"Jan 04",
"Jan 05",
"Jan 06",
"Jan 07",
"Jan 08",
"Jan 09",
"Jan 10",
"Jan 11",
"Jan 12",
"Jan 13",
"Jan 14",
"Jan 15",
"Jan 16",
"Jan 17",
"Jan 18",
"Jan 19",
"Jan 20",
"Jan 21",
"Jan 22",
"Jan 23",
"Jan 24",
"Jan 25",
"Jan 26",
"Jan 27",
"Jan 28",
"Jan 29",
"Jan 30",
"Jan 31",
"Feb 01",
"Feb 02",
"Feb 03",
"Feb 04",
"Feb 05",
"Feb 06",
"Feb 07",
"Feb 08",
"Feb 09",
"Feb 10",
"Feb 11",
"Feb 12",
"Feb 13",
"Feb 14",
"Feb 15",
"Feb 16",
"Feb 17",
"Feb 18",
"Feb 19",
"Feb 20",
"Feb 21",
"Feb 22",
"Feb 23",
"Feb 24",
"Feb 25",
"Feb 26",
"Feb 27",
"Feb 28",
"Mar 01",
"Mar 02",
"Mar 03",
"Mar 04",
"Mar 05",
"Mar 06",
"Mar 07",
"Mar 08",
"Mar 09",
"Mar 10",
"Mar 11",
"Mar 12",
"Mar 13",
"Mar 14",
"Mar 15",
"Mar 16",
"Mar 17",
"Mar 18",
"Mar 19",
"Mar 20",
"Mar 21",
"Mar 22",
"Mar 23",
"Mar 24",
"Mar 25",
"Mar 26",
"Mar 27",
"Mar 28",
"Mar 29",
"Mar 30",
"Mar 31",
"Apr 01",
"Apr 02",
"Apr 03",
"Apr 04",
"Apr 05",
"Apr 06",
"Apr 07",
"Apr 08",
"Apr 09",
"Apr 10",
"Apr 11",
"Apr 12",
"Apr 13",
"Apr 14",
"Apr 15",
"Apr 16",
"Apr 17",
"Apr 18",
"Apr 19",
"Apr 20",
"Apr 21",
"Apr 22",
"Apr 23",
"Apr 24",
"Apr 25",
"Apr 26",
"Apr 27",
"Apr 28",
"Apr 29",
"Apr 30",
"May 01",
"May 02",
"May 03",
"May 04",
"May 05",
"May 06",
"May 07",
"May 08",
"May 09",
"May 10",
"May 11",
"May 12",
"May 13",
"May 14",
"May 15",
"May 16",
"May 17",
"May 18",
"May 19",
"May 20",
"May 21",
"May 22",
"May 23",
"May 24",
"May 25",
"May 26",
"May 27",
"May 28",
"May 29",
"May 30",
"May 31",
"Jun 01",
"Jun 02",
"Jun 03",
"Jun 04",
"Jun 05",
"Jun 06",
"Jun 07",
"Jun 08",
"Jun 09",
"Jun 10",
"Jun 11",
"Jun 12",
"Jun 13",
"Jun 14",
"Jun 15",
"Jun 16",
"Jun 17",
"Jun 18",
"Jun 19",
"Jun 20",
"Jun 21",
"Jun 22",
"Jun 23",
"Jun 24",
"Jun 25",
"Jun 26",
"Jun 27",
"Jun 28",
"Jun 29",
"Jun 30",
"Jul 01",
"Jul 02",
"Jul 03",
"Jul 04",
"Jul 05",
"Jul 06",
"Jul 07",
"Jul 08",
"Jul 09",
"Jul 10",
"Jul 11",
"Jul 12",
"Jul 13",
"Jul 14",
"Jul 15",
"Jul 16",
"Jul 17",
"Jul 18",
"Jul 19",
"Jul 20",
"Jul 21",
"Jul 22",
"Jul 23",
"Jul 24",
"Jul 25",
"Jul 26",
"Jul 27",
"Jul 28",
"Jul 29",
"Jul 30",
"Jul 31",
"Aug 01",
"Aug 02",
"Aug 03",
"Aug 04",
"Aug 05",
"Aug 06",
"Aug 07",
"Aug 08",
"Aug 09",
"Aug 10",
"Aug 11",
"Aug 12",
"Aug 13",
"Aug 14",
"Aug 15",
"Aug 16",
"Aug 17",
"Aug 18",
"Aug 19",
"Aug 20",
"Aug 21",
"Aug 22",
"Aug 23",
"Aug 24",
"Aug 25",
"Aug 26",
"Aug 27",
"Aug 28",
"Aug 29",
"Aug 30",
"Aug 31",
"Sep 01",
"Sep 02",
"Sep 03",
"Sep 04",
"Sep 05",
"Sep 06",
"Sep 07",
"Sep 08",
"Sep 09",
"Sep 10",
"Sep 11",
"Sep 12",
"Sep 13",
"Sep 14",
"Sep 15",
"Sep 16",
"Sep 17",
"Sep 18",
"Sep 19",
"Sep 20",
"Sep 21",
"Sep 22",
"Sep 23",
"Sep 24",
"Sep 25"
],
"total_views": 22,
"share_url": "https://www.instagram.com/stories/growi.io/18072156922998939/"
},
{
"create_time": 1753459032,
"platform": "instagram",
"connected_account_id": 15670,
"username": "growi.io",
"profile_share_url": "https://www.instagram.com/growi.io/",
"date": "Jul 25",
"sorted_dates": [
"Jan 01",
"Jan 02",
"Jan 03",
"Jan 04",
"Jan 05",
"Jan 06",
"Jan 07",
"Jan 08",
"Jan 09",
"Jan 10",
"Jan 11",
"Jan 12",
"Jan 13",
"Jan 14",
"Jan 15",
"Jan 16",
"Jan 17",
"Jan 18",
"Jan 19",
"Jan 20",
"Jan 21",
"Jan 22",
"Jan 23",
"Jan 24",
"Jan 25",
"Jan 26",
"Jan 27",
"Jan 28",
"Jan 29",
"Jan 30",
"Jan 31",
"Feb 01",
"Feb 02",
"Feb 03",
"Feb 04",
"Feb 05",
"Feb 06",
"Feb 07",
"Feb 08",
"Feb 09",
"Feb 10",
"Feb 11",
"Feb 12",
"Feb 13",
"Feb 14",
"Feb 15",
"Feb 16",
"Feb 17",
"Feb 18",
"Feb 19",
"Feb 20",
"Feb 21",
"Feb 22",
"Feb 23",
"Feb 24",
"Feb 25",
"Feb 26",
"Feb 27",
"Feb 28",
"Mar 01",
"Mar 02",
"Mar 03",
"Mar 04",
"Mar 05",
"Mar 06",
"Mar 07",
"Mar 08",
"Mar 09",
"Mar 10",
"Mar 11",
"Mar 12",
"Mar 13",
"Mar 14",
"Mar 15",
"Mar 16",
"Mar 17",
"Mar 18",
"Mar 19",
"Mar 20",
"Mar 21",
"Mar 22",
"Mar 23",
"Mar 24",
"Mar 25",
"Mar 26",
"Mar 27",
"Mar 28",
"Mar 29",
"Mar 30",
"Mar 31",
"Apr 01",
"Apr 02",
"Apr 03",
"Apr 04",
"Apr 05",
"Apr 06",
"Apr 07",
"Apr 08",
"Apr 09",
"Apr 10",
"Apr 11",
"Apr 12",
"Apr 13",
"Apr 14",
"Apr 15",
"Apr 16",
"Apr 17",
"Apr 18",
"Apr 19",
"Apr 20",
"Apr 21",
"Apr 22",
"Apr 23",
"Apr 24",
"Apr 25",
"Apr 26",
"Apr 27",
"Apr 28",
"Apr 29",
"Apr 30",
"May 01",
"May 02",
"May 03",
"May 04",
"May 05",
"May 06",
"May 07",
"May 08",
"May 09",
"May 10",
"May 11",
"May 12",
"May 13",
"May 14",
"May 15",
"May 16",
"May 17",
"May 18",
"May 19",
"May 20",
"May 21",
"May 22",
"May 23",
"May 24",
"May 25",
"May 26",
"May 27",
"May 28",
"May 29",
"May 30",
"May 31",
"Jun 01",
"Jun 02",
"Jun 03",
"Jun 04",
"Jun 05",
"Jun 06",
"Jun 07",
"Jun 08",
"Jun 09",
"Jun 10",
"Jun 11",
"Jun 12",
"Jun 13",
"Jun 14",
"Jun 15",
"Jun 16",
"Jun 17",
"Jun 18",
"Jun 19",
"Jun 20",
"Jun 21",
"Jun 22",
"Jun 23",
"Jun 24",
"Jun 25",
"Jun 26",
"Jun 27",
"Jun 28",
"Jun 29",
"Jun 30",
"Jul 01",
"Jul 02",
"Jul 03",
"Jul 04",
"Jul 05",
"Jul 06",
"Jul 07",
"Jul 08",
"Jul 09",
"Jul 10",
"Jul 11",
"Jul 12",
"Jul 13",
"Jul 14",
"Jul 15",
"Jul 16",
"Jul 17",
"Jul 18",
"Jul 19",
"Jul 20",
"Jul 21",
"Jul 22",
"Jul 23",
"Jul 24",
"Jul 25",
"Jul 26",
"Jul 27",
"Jul 28",
"Jul 29",
"Jul 30",
"Jul 31",
"Aug 01",
"Aug 02",
"Aug 03",
"Aug 04",
"Aug 05",
"Aug 06",
"Aug 07",
"Aug 08",
"Aug 09",
"Aug 10",
"Aug 11",
"Aug 12",
"Aug 13",
"Aug 14",
"Aug 15",
"Aug 16",
"Aug 17",
"Aug 18",
"Aug 19",
"Aug 20",
"Aug 21",
"Aug 22",
"Aug 23",
"Aug 24",
"Aug 25",
"Aug 26",
"Aug 27",
"Aug 28",
"Aug 29",
"Aug 30",
"Aug 31",
"Sep 01",
"Sep 02",
"Sep 03",
"Sep 04",
"Sep 05",
"Sep 06",
"Sep 07",
"Sep 08",
"Sep 09",
"Sep 10",
"Sep 11",
"Sep 12",
"Sep 13",
"Sep 14",
"Sep 15",
"Sep 16",
"Sep 17",
"Sep 18",
"Sep 19",
"Sep 20",
"Sep 21",
"Sep 22",
"Sep 23",
"Sep 24",
"Sep 25"
],
"total_views": 21,
"share_url": "https://www.instagram.com/stories/growi.io/18052947242148951/"
}
]
},
"meta": {
"current_page": 2,
"per_page": 4,
"row_count": 111,
"page_count": 28,
"has_more": true
}
}
Response Fields
| Field | Type | Description |
|---|---|---|
success | Boolean | Indicates if the request was successful |
data.user_contents | Array | Array of user content objects |
data.user_contents[].create_time | Integer | Unix timestamp of when the content was created |
data.user_contents[].platform | String | Platform where the content was posted (tik_tok or instagram) |
data.user_contents[].connected_account_id | Integer | ID of the connected account that posted the content |
data.user_contents[].username | String | Username of the creator |
data.user_contents[].profile_share_url | String | Direct URL to the creator’s profile |
data.user_contents[].date | String | Date when the content was posted (format: “MMM DD”) |
data.user_contents[].sorted_dates | Array | Array of all available dates in “MMM DD” format for filtering |
data.user_contents[].total_views | Integer | Total views within the specified date range (start_date to end_date) |
data.user_contents[].all_time_views | Integer | The post’s current all-time views (only included when include_all_time_views=true) |
data.user_contents[].share_url | String | Direct URL to the content on the platform |
meta.current_page | Integer | Current page number for pagination |
meta.per_page | Integer | Number of results per page |
meta.row_count | Integer | Total number of results across all pages |
meta.page_count | Integer | Total number of pages available |
meta.has_more | Boolean | Indicates if there are more pages available |
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Start date in MM/DD/YYYY format
End date in MM/DD/YYYY format
Limit the number of results. Default is 4. Recommended is 20. Set to 10,000 to get all data.
Page number for pagination. Default is 1.
Number of results per page. Default is 40. Maximum is 100.
Required range:
x <= 100Include the post's current all-time views in the response. Default is false.
Sort results by posted date. Use 'asc' for oldest first or 'desc' for newest first. Case-insensitive. If not provided or invalid, no sorting is applied.
Available options:
asc, desc ⌘I