Read TikTok Smart+ ad groups

POST

/api/v1/tiktok/smart/adgroups

Reads TikTok Upgraded Smart+ ad groups 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+ ad group 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/adgroups' \
--header 'x-api-key;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "adAccountId": "7524374241765212177",
    "fields": [
        "adgroup_id",
        "adgroup_name",
        "primary_status"
    ],
    "filtering": {
        "campaign_ids": [
            "1234567890123456789"
        ]
    },
    "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": [
            {
                "adgroup_id": "1794682309876543210",
                "adgroup_name": "Smart+ Ad Group 1",
                "campaign_id": "1794682301234567890",
                "optimization_goal": "CONVERT",
                "budget_mode": "BUDGET_MODE_DAY",
                "budget": 50,
                "operation_status": "ENABLE",
                "primary_status": "STATUS_DELIVERY_OK",
                "create_time": "2026-03-01 10:05:00"
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 10,
            "total_number": 1,
            "total_page": 1
        }
    }
}

Update TikTok Smart+ campaign status

Create a TikTok Smart+ ad group