tiktok/ads/ads-detail
Retrieve detailed information about a single TikTok ad, including creative content, creator info, and engagement data Analyze ad performance metrics such as views, likes, comments, and other core statistics Help advertis...
Example output — click Run to generate your own
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
https://api.sandbase.ai/v1/runtiktok/ads/ads-detailInput Schema
1 parameters · 1 required · 0 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
ads_id | string | Required | Ad ID, required parameter, can be obtained from ad lists or TikTok Ads Creative Center |
Output Schema
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the generation task |
status | string | Task status: pending, running, completed, failed, timeout |
model | string | Model used for the generation |
outputs | array | Array of output items |
outputs[].url | string | URL of the generated artifact |
outputs[].content_type | string | MIME type (e.g. image/png, video/mp4) |
error | object | null | Error details if failed, null on success |
error.type | string | Machine-readable error type code |
error.message | string | Human-readable error description |
Code Examples
Ready-to-run snippets
curl -X POST https://api.sandbase.ai/v1/run \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "tiktok/ads/ads-detail",
"prompt": "a beautiful sunset over mountains"
}'API README
Get single ad detail
Retrieve detailed information about a single TikTok ad, including creative content, creator info, and engagement data Analyze ad performance metrics such as views, likes, comments, and other core statistics Help advertisers and marketers gain deep insights into specific ad effectiveness and user feedback. It is suitable for tiktok workflows.
Capability
Retrieve detailed information about a single TikTok ad, including creative content, creator info, and engagement data Analyze ad performance metrics such as views, likes, comments, and other core statistics Help advertisers and marketers gain deep insights into specific ad effectiveness and user feedback. It helps applications, agents, and automated workflows turn that capability into repeatable tasks and useful downstream experiences.
Common use cases
- Enrich profiles, accounts, and business records with structured context.
- Power market dashboards, alerts, comparisons, and scheduled data collection.
- Create repeatable integrations that pass structured results to downstream business systems.