TikTok Ads Get Recommended Ads
Find ads similar to a specified reference ad. Provide the required reference material ID in request_body.material_id. You may optionally provide industry, country_code, or cookie; industry and country_code have default values. The response includes recommended ad materials with available titles, brand names, performance and engagement metadata, classification fields, and video details such as duration, cover, dimensions, and playback URLs. Results may be limited, so adjusting or removing filters can help when no materials are returned.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
A fixed charge of 2.07 credits applies per call. Charges are per query. A successful query is billed even if it returns no results.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | Yes | 请求体对象,用于提交参考广告素材 ID(material_id),并可包含行业(industry)、国家代码(country_code)和自定义 Cookie(cookie)以获取相似推荐广告。 | — |
request_body.cookie | string | No | 自定义Cookie字符串(可选) | — |
request_body.industry | string | No | 行业ID/Industry ID | 25308000000 |
request_body.material_id | string | Yes | 广告素材ID/Ad material ID | — |
request_body.country_code | string | No | 国家代码/Country code | US |
Invocation example
Parameter templateGenerated from the parameter configuration. Replace the sample values before use.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_tiktok_ads_get_recommended_ads' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"material_id": "xxx"
}
}
}'No response example available yet.

