Read TikTok insights

GET

/api/v1/tiktok/insights

Reads TikTok reporting insights for a validated ad account owned by the authenticated external user.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Query Params

Header Params

Responses

🟢200OK

application/json

TikTok insights response payload.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.adlyfy.dev/api/v1/tiktok/insights?adAccountId=undefined&externalUserId=undefined&token=undefined&level=undefined&filter=undefined&fields=undefined&start_date=undefined&end_date=undefined&metrics=undefined&dimensions=undefined&report_type=undefined' \
--header 'x-api-key;' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "success": true,
    "message": "Request successful",
    "timestamp": "2026-03-30T12:00:00.000Z",
    "statusCode": 200,
    "data": {
        "list": [
            {
                "dimensions": {
                    "stat_time_day": "2026-03-01"
                },
                "metrics": {
                    "spend": "250.00",
                    "impressions": "40000",
                    "clicks": "1200",
                    "conversion": "35",
                    "cpc": "0.21",
                    "ctr": "3.00"
                }
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 10,
            "total_number": 1,
            "total_page": 1
        }
    }
}

Create TikTok assets

Read TikTok pixels