Read TikTok Smart+ campaigns

POST

/api/v1/tiktok/smart/campaigns

Reads TikTok Upgraded Smart+ campaigns across all Smart+ product families for a validated ad account owned by the authenticated external user. Filters supplied in the filtering object are forwarded verbatim to TikTok.

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 Smart+ campaign list 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/smart/campaigns' \
--header 'x-api-key;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "adAccountId": "7524374241765212177",
    "fields": [
        "campaign_id",
        "campaign_name",
        "primary_status"
    ],
    "filtering": {
        "primary_status": "STATUS_ENABLE"
    },
    "page": 1,
    "page_size": 100
}'

Response Example

200 - Example 1

{
    "success": true,
    "message": "Request successful",
    "timestamp": "2026-03-30T12:00:00.000Z",
    "statusCode": 200,
    "data": {
        "list": [
            {
                "campaign_id": "1794682301234567890",
                "campaign_name": "Smart+ Spring Sales",
                "objective_type": "PRODUCT_SALES",
                "budget_mode": "BUDGET_MODE_DAY",
                "budget": 100,
                "operation_status": "ENABLE",
                "primary_status": "STATUS_DELIVERY_OK",
                "create_time": "2026-03-01 10:00:00"
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 10,
            "total_number": 1,
            "total_page": 1
        }
    }
}

Read TikTok pixel event statistics

Create a TikTok Smart+ campaign