Developer resources

Get recommended CTAs — TikTok Business API

Get recommended CTAs · call it through Quantri360 with one API key for your own accounts / assets that you connected and authorized — 360 handles request signing and refreshing the authorization you granted.

Open in the API index TikTok Business platform page

Get recommended CTAs

GET/creative/cta/recommend/Via 360: GET https://partner.quantri360.com/v1/tiktok_business/creative/cta/recommend/

Description

Use this endpoint to get recommended call-to-actions (CTAs) that you can use to create or update your ads.

See CTA recommendations to find out the introduction of the two types of recommended CTAs (Standard Recommended CTAs and Dynamic CTAs).

Request

Endpoint

GET https://partner.quantri360.com/v1/tiktok_business/creative/cta/recommend/

Authentication & shop

Name	In	Type	Sample	Description
Authorization	header	header	Bearer q360_live_ab12cd34_…	Khóa API của brand (tạo ở mục API key). Bắt buộc với mọi request. Brand suy từ key — không truyền mã brand.
platform_shop_id	query	string	7000000000000000001	Tài sản TikTok Business đã kết nối — "Mã tài sản" ở trang Nền tảng hoặc GET /v1/platforms (tài khoản quảng cáo cho Marketing API, tài khoản TikTok cho Organic / Messaging). Có thể bỏ khi chỉ kết nối một tài sản.

Request parameters

Name	In	Type	Required	Description
new_version	query	boolean	No	Whether to use the new version of the endpoint that supports retrieval of Dynamic CTAs based on your ad settings. Supported values: `true`, `false`. Default value: `false`.
asset_type	query	string	No	- Required when `new_version` is `false` or not passed. - Ignored when `new_version` is `true`. The asset type. Enum values： - `CTA_NORMAL`: Standard Recommended CTAs. - `CTA_AUTO_OPTIMIZED`: Dynamic CTAs.
content_type	query	string	No	- Required when `new_version` is `false` or not passed. - Ignored when `new_version` is `true`. The ads content type. Enum values: - `APP_DOWNLOAD` - `LANDING_PAGE` - `OTHER` - `MESSAGE` : a Lead Generation ad with promotion type as TikTok direct message. - `SOCIAL_MEDIA_APP_MESSAGE` : a Lead Generation ad with promotion type as social media app. - `PHONE_CALL`: a Lead Generation ad with promotion type as phone call.
objective_type	query	string	No	- Required when `new_version` is `true`. - Not supported when `new_version` is `false` or not passed. Advertising objective. For enum values and descriptions, see Objectives.
promotion_type	query	string	No	- Required when `new_version` is `true`. - Not supported when `new_version` is `false` or not passed. Promotion type (Optimization location). For enum values, see Enumeration - Promotion Type.
language	query	string	No	Valid only when `new_version` is `true`. The code of language for the recommended CTAs. To obtain the list of available language codes, use /tool/language/. Default value: `en`. For example, if you set this field to `fr`, the returned `asset_content` will be in French.
placements	query	string[]	No	Valid only when `new_version` is `true`. The apps where you want to deliver your ads. Enum values: - `PLACEMENT_TIKTOK`: TikTok. - `PLACEMENT_PANGLE`: Pangle. - `PLACEMENT_GLOBAL_APP_BUNDLE`: Global App Bundle. Note: Due to limited historical data for generating customized results, you might receive the same recommended CTAs even if you provide a different value for this field.
region_codes	query	string[]	No	Valid only when `new_version` is `true`. Codes of the regions that you want to target. For enum values, see Location code. Example: `US`. Note: Due to limited historical data for generating customized results, you might receive the same recommended CTAs even if you provide a different value for this field.
optimization_goal	query	string	No	Valid only when `new_version` is `true`. The measurable results you'd like to drive with your ads. For a complete list of enum values, see Enumeration - Optimization Goal. Note: Due to limited historical data for generating customized results, you might receive the same recommended CTAs even if you provide a different value for this field.
ad_texts	query	string[]	No	Valid only when `new_version` is `true`. A list of ad texts. Each ad text is shown to your audience as part of your ad creative, to deliver the message you intend to communicate to them. - Ad text must be 1-100 characters long and cannot contain emoji. - Each word in Chinese or Japanese counts as two characters, while each letter in English counts as one character. Recommended size: 1. If you don't know how to create effective ad texts, you can try the Smart Text feature, which generates ad text recommendations based on the industry and language. Note: Due to limited historical data for generating customized results, you might receive the same recommended CTAs even if you provide a different value for this field.
landing_page_url	query	string	No	Valid only when `new_version` is `true`. The landing page that users will be redirected to. Note: Due to limited historical data for generating customized results, you might receive the same recommended CTAs even if you provide a different value for this field.

Request examples

curl -s "https://partner.quantri360.com/v1/tiktok_business/creative/cta/recommend/" \
  -H "Authorization: Bearer $KEY"

Python

import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.get(
    "https://partner.quantri360.com/v1/tiktok_business/creative/cta/recommend/",
    params={},
    headers={"Authorization": f"Bearer {KEY}"},
    timeout=60,
)
print(r.status_code)
print(r.json())

Node.js

const KEY = 'q360_live_...'; // khóa API của brand
const url = new URL('https://partner.quantri360.com/v1/tiktok_business/creative/cta/recommend/');
for (const [k, v] of Object.entries({})) url.searchParams.set(k, typeof v === 'object' ? JSON.stringify(v) : String(v));
const r = await fetch(url, {
  method: 'GET',
  headers: { Authorization: `Bearer ${KEY}` },
});
console.log(r.status, await r.json());

PHP

<?php
$key = 'q360_live_...'; // khóa API của brand
$url = 'https://partner.quantri360.com/v1/tiktok_business/creative/cta/recommend/' . '?' . http_build_query([]);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $key]);
$res = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status, "\n", $res;

Response

Response fields (as returned by TikTok Business)

Name	Type	Description
message	string	The return message. For details, see Appendix-Return Codes.
code	number	The return code. For details, see Appendix-Return Codes.
data	object	The returned data.
recommend_assets	object[]	The recommended assets.
asset_ids	string[]	The asset IDs of recommended CTAs
asset_content	string	The CTA text. For example, `"Learn More"`.
request_id	string	The request log ID

Response sample

HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "recommend_assets": [
            {
                "asset_ids": [
                    "201902",
                    "201404"
                ],
                "asset_content": "Download now"
            },
            {
                "asset_ids": [
                    "202114",
                    "201743"
                ],
                "asset_content": "Install now"
            },
            {
                "asset_ids": [
                    "201850",
                    "201352"
                ],
                "asset_content": "Install app"
            },
            {
                "asset_ids": [
                    "202141",
                    "201716"
                ],
                "asset_content": "Enroll today"
            },
            {
                "asset_ids": [
                    "201899",
                    "201401"
                ],
                "asset_content": "Check it now"
            },
            {
                "asset_ids": [
                    "201808",
                    "201598"
                ],
                "asset_content": "Check in app"
            },
            {
                "asset_ids": [
                    "201836",
                    "201628"
                ],
                "asset_content": "Try this new app"
            },
            {
                "asset_ids": [
                    "202116",
                    "201740"
                ],
                "asset_content": "Install app now"
            },
            {
                "asset_ids": [
                    "201934",
                    "202158"
                ],
                "asset_content": "Download"
            },
            {
                "asset_ids": [
                    "202124",
                    "201733"
                ],
                "asset_content": "Install it now"
            }
        ]
    }
}

Get started

Sign up for Partner
Enable a data type of the Ads (Marketing API) group on the platform page
Create an API key (tick the TikTok Business channel)
Call it as in the examples above