Skip to main content
GET
Get a single TikTok ad by its ScoutLayer ad id

Authorizations

X-API-Key
string
header
required

API key passed as the X-API-Key request header. Recommended for server-to-server calls.

Path Parameters

adId
string
required
Minimum string length: 1
Example:

"1234567890123456789"

Response

Get a single TikTok ad by its ScoutLayer ad id

adId
string
required

Stable id ScoutLayer assigns — pass this straight into the matching ads.get endpoint, ScoutLayer resolves it back to whatever URL/id-pair the underlying network actually needs

advertiserId
string
required
advertiserName
string
required
isActive
boolean | null
required
firstShownAt
string | null
required
lastShownAt
string | null
required
format
enum<string>
required
Available options:
text,
image,
video,
carousel,
unknown
platforms
string[]
required

Where the ad ran (e.g. facebook, instagram) — only Meta reports this today, other networks return []

creative
object
required
landingUrl
string | null
required
previewUrl
string | null
required
metrics
object
required
checkedAt
string
required