TikTok Ads Get Ads Detail
2.07 credits/call
ae_tiktok_ads_get_ads_detail
获取单个广告的详细信息。请在 `request_body` 中提供必填的 `ads_id` 字符串;`cookie` 为可选自定义 Cookie 字符串。返回广告标题、品牌、点赞/评论/分享数、点击率、投放国家代码、广告目标、关键词、落地页、标签,以及视频 ID、时长、尺寸、封面和可用播放地址等信息。
2.07 credits/call
Pricing
2.07 credits/call
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
2.07 credits/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 及可选的自定义 Cookie。 | — |
request_body.ads_id | string | Yes | 广告ID/Ad ID | — |
request_body.cookie | string | No | 自定义Cookie字符串(可选) | — |
Invocation example
Parameter templateGenerated from the parameter configuration. Replace the sample values before use.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest coderequest.sh
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_tiktok_ads_get_ads_detail' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"ads_id": "xxx"
}
}
}'No response example available yet.

