> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sociavault.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Ad Details

> Retrieve the full details for a single TikTok Creative Center Top Ad by its ad ID, including creative assets, metrics, and metadata.

**Credit Cost:** 1 credit per request

<Note>💳 **1 credit per request**</Note>


## OpenAPI

````yaml GET /v1/scrape/tiktok-ad-library/ad
openapi: 3.1.0
info:
  title: SociaVault API
  version: 1.0.0
  description: >-
    # SociaVault API Documentation


    The SociaVault API provides comprehensive access to social media data
    extraction across multiple platforms.


    ## Features


    - **Multi-Platform Support**: TikTok, Instagram, YouTube, Facebook, Twitter,
    Reddit, Threads, and more

    - **Credit-Based System**: Pay-as-you-go pricing with transparent credit
    costs

    - **High Performance**: Fast, reliable data extraction

    - **Comprehensive Data**: Detailed user profiles, videos, posts, comments,
    and analytics


    ## Authentication


    All API requests require authentication using an API key in the `X-API-Key`
    header:


    ```bash

    X-API-Key: sk_live_your_api_key_here

    ```


    Get your API key from the [SociaVault
    Dashboard](https://sociavault.com/dashboard).


    ## Credits


    Each endpoint consumes credits based on data complexity:

    - Simple requests (profiles): 1 credit

    - Complex requests (demographics): 20+ credits

    - Paginated requests: Credits per page


    Check your credit balance in the dashboard or via the API.


    ## Support


    - **Documentation**: https://docs.sociavault.com

    - **Email**: support@sociavault.com

    - **Discord**: https://discord.gg/sociavault
  contact:
    name: SociaVault Support
    email: support@sociavault.com
    url: https://sociavault.com/support
  license:
    name: Commercial
    url: https://sociavault.com/terms
servers:
  - url: https://api.sociavault.com
    description: Production API
security:
  - ApiKeyAuth: []
tags:
  - name: account
    description: Account management and credit balance
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/account
  - name: tiktok
    description: Scrape TikTok profiles, videos, and more
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/tiktok
  - name: tiktok-shop
    description: Everything about TikTok Shop
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/tiktok-shop
  - name: instagram
    description: Gets Instagram profiles, posts, and reels
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/instagram
  - name: youtube
    description: Scrape YouTube channels, videos, and more
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/youtube
  - name: linkedin
    description: Scrape LinkedIn
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/linkedin
  - name: facebook
    description: Get public Facebook profiles and posts
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/facebook
  - name: facebookAdLibrary
    description: Scrapes the Facebook (Meta) Ad Library
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/facebookAdLibrary
  - name: facebookMarketplace
    description: Search Facebook Marketplace and pull full listing details
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/facebookMarketplace
  - name: googleAdLibrary
    description: >-
      Scrape the Google Ad Transparency Library. *This only gets the public ads.
      Some ads you need to log in for and sadly we can't get those. Also, since
      there are so many variations, the return types might not all be 100% the
      same.
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/googleAdLibrary
  - name: linkedinAdLibrary
    description: Search the LinkedIn Ad Library
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/linkedinAdLibrary
  - name: twitter
    description: Get Twitter profiles, tweets, followers and more
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/twitter
  - name: reddit
    description: Scrape Reddit posts and comments
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/reddit
  - name: threads
    description: Get Threads posts
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/threads
  - name: google
    description: Scrape Google search results
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/google
paths:
  /v1/scrape/tiktok-ad-library/ad:
    get:
      tags:
        - tiktok-ad-library
      summary: Get Ad Details
      description: >-
        Retrieve the full details for a single TikTok Creative Center Top Ad by
        its ad ID, including creative assets, metrics, and metadata.


        **Credit Cost:** 1 credit per request
      operationId: tiktok_ad_library_Ad
      parameters:
        - name: ad_id
          in: query
          description: The TikTok Creative Center ad ID.
          required: true
          schema:
            type: string
            example: '7448078361224445953'
      responses:
        '200':
          description: >-
            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
          content:
            application/json:
              example:
                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
        '400':
          description: Bad Request - Missing required parameter
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: string
                    example: ad_id parameter is required
        '401':
          description: Unauthorized - Invalid or missing API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: string
                    example: User not authenticated
        '402':
          description: Payment Required - Insufficient credits
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: string
                    example: Insufficient credits
                  required:
                    type: integer
                    example: 1
                  available:
                    type: integer
                    example: 0
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: |-
        API key for authentication. Format: `sk_live_xxxxxxxxxxxxx`

        Get your API key from the [Dashboard](https://sociavault.com/dashboard).

````