{
  "info": {
    "_postman_id": "c6d5e0ff-2ee6-4bb4-be7d-01a254abb316",
    "name": "TikTok API for Business Ad Groups Reporting API",
    "description": "TikTok's advertising API enabling developers to create and manage ad campaigns, ad groups, creatives, audiences, and reporting for global advertisers on TikTok's platform.\n\nContact Support:\n Name: TikTok API for Business",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "createdAt": "2026-07-28T03:14:18.000Z",
    "updatedAt": "2026-07-28T03:14:18.000Z",
    "lastUpdatedBy": "35240",
    "uid": "35240-c6d5e0ff-2ee6-4bb4-be7d-01a254abb316"
  },
  "item": [
    {
      "name": "open_api",
      "item": [
        {
          "name": "v1.3",
          "item": [
            {
              "name": "report",
              "item": [
                {
                  "name": "integrated",
                  "item": [
                    {
                      "name": "get",
                      "item": [
                        {
                          "name": "Get Integrated Report",
                          "id": "1f83fa22-b218-41c3-a5c1-a4ca563ac05f",
                          "protocolProfileBehavior": {
                            "disableBodyPruning": true
                          },
                          "request": {
                            "method": "GET",
                            "header": [
                              {
                                "key": "Accept",
                                "value": "application/json"
                              }
                            ],
                            "url": {
                              "raw": "{{baseUrl}}/open_api/v1.3/report/integrated/get/?advertiser_id=<string>&report_type=BC&data_level=AUCTION_AD&dimensions=<string>&metrics=<string>&start_date=<string>&end_date=<string>&page=1&page_size=20",
                              "host": [
                                "{{baseUrl}}"
                              ],
                              "path": [
                                "open_api",
                                "v1.3",
                                "report",
                                "integrated",
                                "get",
                                ""
                              ],
                              "query": [
                                {
                                  "description": "(Required) ",
                                  "key": "advertiser_id",
                                  "value": "<string>"
                                },
                                {
                                  "description": "(Required) Type of report to generate",
                                  "key": "report_type",
                                  "value": "BC"
                                },
                                {
                                  "description": "(Required) Data aggregation level",
                                  "key": "data_level",
                                  "value": "AUCTION_AD"
                                },
                                {
                                  "description": "(Required) Comma-separated dimensions (e.g., campaign_id,stat_time_day)",
                                  "key": "dimensions",
                                  "value": "<string>"
                                },
                                {
                                  "description": "(Required) Comma-separated metrics (e.g., impressions,clicks,spend)",
                                  "key": "metrics",
                                  "value": "<string>"
                                },
                                {
                                  "description": "(Required) Start date in YYYY-MM-DD format",
                                  "key": "start_date",
                                  "value": "<string>"
                                },
                                {
                                  "description": "(Required) End date in YYYY-MM-DD format",
                                  "key": "end_date",
                                  "value": "<string>"
                                },
                                {
                                  "key": "page",
                                  "value": "1"
                                },
                                {
                                  "key": "page_size",
                                  "value": "20"
                                }
                              ]
                            },
                            "description": "Retrieves advertising performance reports with customizable dimensions, metrics, and date ranges. Supports BASIC, AUDIENCE, and CATALOG report types."
                          },
                          "response": [
                            {
                              "id": "cce923d2-43bf-48d6-81d6-d63e278a49a1",
                              "name": "Report data returned successfully",
                              "originalRequest": {
                                "method": "GET",
                                "header": [
                                  {
                                    "key": "Accept",
                                    "value": "application/json"
                                  },
                                  {
                                    "description": "Added as a part of security scheme: apikey",
                                    "key": "Access-Token",
                                    "value": "<API Key>"
                                  }
                                ],
                                "url": {
                                  "raw": "{{baseUrl}}/open_api/v1.3/report/integrated/get/?advertiser_id=<string>&report_type=BC&data_level=AUCTION_AD&dimensions=<string>&metrics=<string>&start_date=<string>&end_date=<string>&page=1&page_size=20",
                                  "host": [
                                    "{{baseUrl}}"
                                  ],
                                  "path": [
                                    "open_api",
                                    "v1.3",
                                    "report",
                                    "integrated",
                                    "get",
                                    ""
                                  ],
                                  "query": [
                                    {
                                      "description": "(Required) ",
                                      "key": "advertiser_id",
                                      "value": "<string>"
                                    },
                                    {
                                      "description": "(Required) Type of report to generate",
                                      "key": "report_type",
                                      "value": "BC"
                                    },
                                    {
                                      "description": "(Required) Data aggregation level",
                                      "key": "data_level",
                                      "value": "AUCTION_AD"
                                    },
                                    {
                                      "description": "(Required) Comma-separated dimensions (e.g., campaign_id,stat_time_day)",
                                      "key": "dimensions",
                                      "value": "<string>"
                                    },
                                    {
                                      "description": "(Required) Comma-separated metrics (e.g., impressions,clicks,spend)",
                                      "key": "metrics",
                                      "value": "<string>"
                                    },
                                    {
                                      "description": "(Required) Start date in YYYY-MM-DD format",
                                      "key": "start_date",
                                      "value": "<string>"
                                    },
                                    {
                                      "description": "(Required) End date in YYYY-MM-DD format",
                                      "key": "end_date",
                                      "value": "<string>"
                                    },
                                    {
                                      "key": "page",
                                      "value": "1"
                                    },
                                    {
                                      "key": "page_size",
                                      "value": "20"
                                    }
                                  ]
                                }
                              },
                              "status": "OK",
                              "code": 200,
                              "_postman_previewlanguage": "json",
                              "header": [
                                {
                                  "key": "Content-Type",
                                  "value": "application/json"
                                }
                              ],
                              "cookie": [],
                              "responseTime": null,
                              "body": "{\n  \"code\": \"<integer>\",\n  \"message\": \"<string>\",\n  \"data\": {\n    \"list\": [\n      {\n        \"dimensions\": {},\n        \"metrics\": {}\n      },\n      {\n        \"dimensions\": {},\n        \"metrics\": {}\n      }\n    ],\n    \"page_info\": {\n      \"page\": \"<integer>\",\n      \"page_size\": \"<integer>\",\n      \"total_number\": \"<integer>\",\n      \"total_page\": \"<integer>\"\n    }\n  }\n}",
                              "createdAt": "2026-07-28T03:14:19.000Z",
                              "updatedAt": "2026-07-28T03:14:19.000Z",
                              "uid": "35240-cce923d2-43bf-48d6-81d6-d63e278a49a1"
                            }
                          ],
                          "createdAt": "2026-07-28T03:14:19.000Z",
                          "updatedAt": "2026-07-28T03:14:19.000Z",
                          "uid": "35240-1f83fa22-b218-41c3-a5c1-a4ca563ac05f"
                        }
                      ],
                      "id": "70b5aba4-a61b-4b3a-8726-9574c3db251e",
                      "createdAt": "2026-07-28T03:14:19.000Z",
                      "updatedAt": "2026-07-28T03:14:19.000Z",
                      "uid": "35240-70b5aba4-a61b-4b3a-8726-9574c3db251e"
                    }
                  ],
                  "id": "837d6399-bc0f-4c43-ba0b-4879733cc641",
                  "createdAt": "2026-07-28T03:14:19.000Z",
                  "updatedAt": "2026-07-28T03:14:19.000Z",
                  "uid": "35240-837d6399-bc0f-4c43-ba0b-4879733cc641"
                }
              ],
              "id": "16f10221-2ca6-4d7a-a6d8-205e5035d1c9",
              "createdAt": "2026-07-28T03:14:19.000Z",
              "updatedAt": "2026-07-28T03:14:19.000Z",
              "uid": "35240-16f10221-2ca6-4d7a-a6d8-205e5035d1c9"
            }
          ],
          "id": "ff419fae-a24a-4d80-8bd2-f21f15733d72",
          "createdAt": "2026-07-28T03:14:19.000Z",
          "updatedAt": "2026-07-28T03:14:19.000Z",
          "uid": "35240-ff419fae-a24a-4d80-8bd2-f21f15733d72"
        }
      ],
      "id": "411c1b45-f216-466e-b3cf-2decc3cc78b2",
      "createdAt": "2026-07-28T03:14:19.000Z",
      "updatedAt": "2026-07-28T03:14:19.000Z",
      "uid": "35240-411c1b45-f216-466e-b3cf-2decc3cc78b2"
    }
  ],
  "auth": {
    "type": "apikey",
    "apikey": [
      {
        "key": "key",
        "value": "Access-Token",
        "type": "string"
      },
      {
        "key": "value",
        "value": "{{apiKey}}",
        "type": "string"
      },
      {
        "key": "in",
        "value": "header",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://business-api.tiktok.com"
    }
  ]
}