Skip to main content
GET
/
v1
/
scrape
/
tiktok-ad-library
/
ad
Get Ad Details
curl --request GET \
  --url https://api.sociavault.com/v1/scrape/tiktok-ad-library/ad \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "data": {
    "success": true,
    "ad_title": "HR would like to remind you that what happens at the premiere, stays at the premiere. Office Romance June 5 on @Netflix ",
    "brand_name": "",
    "comment": 5,
    "cost": 1,
    "country_code": {
      "0": "IT",
      "1": "US"
    },
    "ctr": 0.34,
    "favorite": false,
    "has_summary": false,
    "highlight_text": "",
    "id": "7645249124891607041",
    "industry_key": "label_23108000000",
    "is_search": false,
    "keyword_list": null,
    "landing_page": "https://www.tiktok.com/music/On-The-Floor-6917324503026501634",
    "like": 1294,
    "objective_key": "campaign_objective_traffic",
    "objectives": {
      "0": {
        "label": "campaign_objective_traffic",
        "value": 1
      },
      "1": {
        "label": "campaign_objective_video_view",
        "value": 4
      }
    },
    "pattern_label": {},
    "share": 7,
    "source": "Others",
    "source_key": 73,
    "video_info": {
      "vid": "v15044gf0000d8blg3vog65m7i2j3320",
      "duration": 55.843,
      "cover": "https://p16-common-sign.tiktokcdn.com/tos-maliva-p-0068c799-us/owWoFXnfIfGLjgWAuAYQXIeqGAQpGQGYReBQGU~tplv-noop.image?dr=18692&refresh_token=a401619e&x-expires=1781236924&x-signature=0q9GnoMTxEoF759h1QvLdjpRsuU%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=317596d8&idc=my&VideoID=v15044gf0000d8blg3vog65m7i2j3320",
      "video_url": {
        "540p": "https://v16m-default.tiktokcdn.com/d53a2e8ebaf61e24b6ed926c6320d98d/6a2b84bc/video/tos/maliva/tos-maliva-ve-0068c799-us/osXAIFIWHpGGG8AGAefjLRXQeYUgUoIRWpQfQ3/?a=0&bti=NTU4QDM1NGA%3D&&bt=511&ft=cApXJCz7ThWH8o59LGZmo0P&mime_type=video_mp4&rc=M2Q7ZDVpODY8NjhpOjk4ZkBpMzZtbHA5cjZvOzMzaTczNEBeLl9fYl4tXzUxNDNiMC40YSMvMC80MmRzZF9hLS1kMTJzcw%3D%3D&vvpl=1&l=20260612060109989AA740FBB80D56854A&btag=e00088000",
        "720p": "https://v16m-default.tiktokcdn.com/1f68163dfffabe98b7dce396d7775f67/6a2b84bc/video/tos/maliva/tos-maliva-ve-0068c799-us/ocf1SxIUCtBCUXsiEWiwHIRIiEJIEAA26jQqPA/?a=0&bti=NTU4QDM1NGA%3D&&bt=1360&ft=cApXJCz7ThWH8o59LGZmo0P&mime_type=video_mp4&rc=Z2U2OWRlOzw8aTY4aGY5ZUBpMzZtbHA5cjZvOzMzaTczNEAyMi80YzQ1XzAxX2AyYTA1YSMvMC80MmRzZF9hLS1kMTJzcw%3D%3D&vvpl=1&l=20260612060109989AA740FBB80D56854A&btag=e00088000"
      },
      "width": 720,
      "height": 1280
    },
    "voice_over": false,
    "creative_center_url": "https://ads.tiktok.com/business/creativecenter/topads/7645249124891607041/pc/en",
    "detail_analysis": null,
    "interactive_time_analysis": {
      "ctr": {
        "metric": "retain_ctr",
        "analysis": {
          "0": {
            "second": 0,
            "value": 0.05587075347678683
          },
          "1": {
            "second": 1,
            "value": 1
          },
          "2": {
            "second": 2,
            "value": 0.30602643049885836
          }
        },
        "duration": 57,
        "highlight": {
          "0": 1,
          "1": 3,
          "2": 10
        },
        "percentile": 0.99
      },
      "cvr": {
        "metric": "retain_cvr",
        "analysis": {
          "0": {
            "second": 0,
            "value": 0
          },
          "1": {
            "second": 1,
            "value": 0
          },
          "2": {
            "second": 2,
            "value": 0
          }
        },
        "duration": 57,
        "highlight": {},
        "percentile": 0.99
      },
      "clicks": {
        "metric": "click_cnt",
        "analysis": {
          "0": {
            "second": 0,
            "value": 0.24581005586592178
          },
          "1": {
            "second": 1,
            "value": 1
          },
          "2": {
            "second": 2,
            "value": 0.12290502793296089
          },
          "3": {
            "second": 3,
            "value": 0.07681564245810056
          }
        },
        "duration": 57,
        "highlight": {
          "0": 1,
          "1": 14,
          "2": 20
        },
        "percentile": 0.99
      },
      "conversion": {
        "metric": "convert_cnt",
        "analysis": {
          "0": {
            "second": 0,
            "value": 0
          },
          "1": {
            "second": 1,
            "value": 0
          },
          "2": {
            "second": 2,
            "value": 0
          }
        },
        "duration": 57,
        "highlight": {},
        "percentile": 0.99
      },
      "remain": {
        "metric": "play_retain_cnt",
        "analysis": {
          "0": {
            "second": 0,
            "value": 1
          },
          "1": {
            "second": 1,
            "value": 0.22727689795019543
          },
          "2": {
            "second": 2,
            "value": 0.09127777879727672
          },
          "3": {
            "second": 3,
            "value": 0.05455746609656286
          }
        },
        "duration": 57,
        "highlight": {},
        "percentile": 0.99
      }
    },
    "recommended_for_you": {
      "0": {
        "ad_title": "Tap to see what happens next",
        "brand_name": "",
        "cost": 1,
        "ctr": 0.07,
        "favorite": false,
        "id": "7637749703787200520",
        "industry_key": "label_23108000000",
        "is_search": false,
        "like": 2821,
        "objective_key": "campaign_objective_conversion",
        "video_info": {
          "vid": "v10033g50000d8c4sovog65tgqn0rfig",
          "duration": 146.774,
          "cover": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/oAlc2BoB1AT9v8NiiBKC9AEhBA4YfDPwqmIm4x~tplv-noop.image?dr=18692&refresh_token=8a189428&x-expires=1781237016&x-signature=ZZF1qNndZBjyZEWGELwEz7nEpik%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=317596d8&idc=my&VideoID=v10033g50000d8c4sovog65tgqn0rfig",
          "video_url": {
            "360p": "https://v16m-default.tiktokcdn.com/8bb3a9f6a760f22afaf0fe54913fde76/6a2b8518/video/tos/alisg/tos-alisg-ve-0051c001-sg/okv8QF1GEIXQAMfJrefvOW9AbNmHTDgSDgzSCD/?a=0&bti=NTU4QDM1NGA%3D&&bt=619&ft=cApXJCz7ThWHbo59LGZmo0P&mime_type=video_mp4&rc=ODUzOGc5NDZmaWQ3NDY7ZkBpamkzdHc5cnI3OzMzODYzNEBeNjA2NjEtNWAxNDRjYTAwYSNmb2tkMmRzcGBhLS1kMC1zcw%3D%3D&vvpl=1&l=2026061206011055E5D8C54FD30D965C4A&btag=e00090000",
            "480p": "https://v16m-default.tiktokcdn.com/7b2ba2bbb8f176c235587f9f7b4cefca/6a2b8518/video/tos/alisg/tos-alisg-ve-0051c001-sg/owge7rfI2MtkARIguKLPAvvGAcA2fMqSeueZS5/?a=0&bti=NTU4QDM1NGA%3D&&bt=888&ft=cApXJCz7ThWHbo59LGZmo0P&mime_type=video_mp4&rc=Zmc4NTg1NGYzODNkMzs3NUBpamkzdHc5cnI3OzMzODYzNEAuMjBiMi1gNV8xLWA0Ni0yYSNmb2tkMmRzcGBhLS1kMC1zcw%3D%3D&vvpl=1&l=2026061206011055E5D8C54FD30D965C4A&btag=e00090000",
            "540p": "https://v16m-default.tiktokcdn.com/c8c86c6b661ba22cf498fe70a46d3681/6a2b8518/video/tos/alisg/tos-alisg-ve-0051c001-sg/owIbvgTAr9k1i9OeDDQJQfFHNkgCSAf8EvGCmV/?a=0&bti=NTU4QDM1NGA%3D&&bt=1005&ft=cApXJCz7ThWHbo59LGZmo0P&mime_type=video_mp4&rc=OTY8ZWdnOGQ7MzNpOjU4ZkBpamkzdHc5cnI3OzMzODYzNEBgMGJgYC9hNjAxNDBgX2AtYSNmb2tkMmRzcGBhLS1kMC1zcw%3D%3D&vvpl=1&l=2026061206011055E5D8C54FD30D965C4A&btag=e00090000",
            "720p": "https://v16m-default.tiktokcdn.com/a96383a70c684d7f1435ad5baaca930e/6a2b8518/video/tos/alisg/tos-alisg-ve-0051c001-sg/oIt3rM7kA5qRgBSPcuALIfSegKMe1eie4AGvZr/?a=0&bti=NTU4QDM1NGA%3D&&bt=1748&ft=cApXJCz7ThWHbo59LGZmo0P&mime_type=video_mp4&rc=NDc1aTQ2O2U2OTc7OWY3Z0BpamkzdHc5cnI3OzMzODYzNEAxNl5fY2MyXzIxMGAzNjAzYSNmb2tkMmRzcGBhLS1kMC1zcw%3D%3D&vvpl=1&l=2026061206011055E5D8C54FD30D965C4A&btag=e00090000"
          },
          "width": 720,
          "height": 1280
        }
      }
    }
  },
  "credits_used": 1
}
💳 1 credit per request

Authorizations

X-API-Key
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx

Get your API key from the Dashboard.

Query Parameters

ad_id
string
required

The TikTok Creative Center ad ID.

Example:

"7448078361224445953"

Response

Successful response containing ad details

Key Response Fields:

  • id: Unique ad ID
  • ad_title: Ad creative text/caption
  • brand_name: Brand name (if available)
  • like: Total likes
  • comment: Total comments
  • share: Total shares
  • ctr: Click-through rate
  • country_code: Countries where the ad ran
  • industry_key: Industry category identifier
  • objective_key: Primary campaign objective
  • objectives[]: All objectives with label and weight
  • landing_page: Ad destination URL
  • source: Ad source type
  • video_info.duration: Video length in seconds
  • video_info.cover: Video cover/thumbnail URL
  • video_info.video_url: Download URLs by quality (540p, 720p)
  • video_info.width: Video width in pixels
  • video_info.height: Video height in pixels
  • creative_center_url: Link to the ad on TikTok Creative Center
  • interactive_time_analysis: Second-by-second metrics for CTR, CVR, clicks, conversions, and retention
  • recommended_for_you: Related ads suggested by Creative Center