Read TikTok pixel event statistics

POST

/api/v1/tiktok/pixels/events

Reads TikTok pixel event statistics 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: ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

TikTok pixel event stats 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/pixels/events' \
--header 'x-api-key;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "adAccountId": "7524374241765212177",
    "pixel_ids": [
        "7193226612345678901"
    ],
    "start_date": "2026-05-01",
    "end_date": "2026-05-10"
}'

Response Example

200 - Example 1

{
    "success": true,
    "message": "Request successful",
    "timestamp": "2026-03-30T12:00:00.000Z",
    "statusCode": 200,
    "data": {
        "pixels": [
            {
                "pixel_id": "7193226612345678901",
                "events": [
                    {
                        "type": "CompletePayment",
                        "statistics": {
                            "count": "512",
                            "value": "10240.00"
                        }
                    }
                ]
            }
        ]
    }
}

Read TikTok pixels

Read TikTok Smart+ campaigns