Creative features of an ad: hook, offers, urgency, social proof, format, video length, cuts, on-image text

GET/v1/ads/{id}/features

Rule-based and measured, no AI model: every text tag carries the exact text it matched, media properties are measured with ffprobe/ffmpeg and on-image text is read with tesseract (words under 60% confidence are dropped). Results are kept per ad version; a changed creative is analysed again. Costs the features price (default 2 credits) per call, plus the ad itself if it has to be fetched live.

Example request

Shell

curl "https://api.adlibapi.com/v1/ads/meta:1187430977361020/features" \
  -H "X-API-Key: $ADLIB_API_KEY"

Send your key in the X-API-Key header. Try it in the explorer.

Parameters

idrequired

path · string

e.g. meta:1187430977361020

Response

data.cta

string

–

data.formatrequired

string

From the measured media: vertical_video, horizontal_video, square_video, vertical_image, square_image, horizontal_image, carousel, text_only

data.headline

string

–

data.landing

object

–

domain

string

–

path

string

–

url

string

–

utm

map of string

–

data.mediarequired

object[]

–

aspect

string

9:16, 4:5, 1:1, 16:9 or WxH reduced

cuts_per_minute

number

–

duration_s

number

–

error

string

–

has_audio

boolean

–

height

integer

–

kind

string

One of image, video

ocr

object

–

orientation

string

One of vertical, square, horizontal

scene_cuts

integer

Hard cuts detected (ffmpeg scene score > 0.4)

url

string

–

width

integer

–

data.methodrequired

string

rules = text rules with evidence, measurement = ffprobe/ffmpeg, ocr = tesseract; no AI model

data.ocr_text

string

–

data.textrequired

object

–

chars

integer

–

discounts

string[]

–

emojis

integer

–

free_offer

object[]

–

free_shipping

object[]

–

guarantee

object[]

–

hashtags

string[]

–

hook

string

First sentence of the primary text

hook_is_question

boolean

–

mentions

string[]

–

novelty

object[]

–

numbers

string[]

–

prices

string[]

–

social_proof

object[]

–

uppercase_ratio

number

Share of letters in capitals

urgency

object[]

–

words

integer

–

data.versionrequired

string

–

metarequired

object

–

ad_id

string

–

analyzed_at

datetime

–

cached

boolean

Served from an earlier analysis of the same ad version