抖音广告库API - 广告创意和广告主 API

API ID 14743

按关键字、广告主或广告ID搜索公共TikTok广告库:广告主、广告文本、媒体网址、首次和最后一次展示日期、地区和状态。限制:每次调用最多返回25个广告

7,558 ms 平均响应

API 文档

端点

请求
搜索 TikTok 广告库广告及查询参数
Endpoint ID: 38169
GET https://zylalabs.com/api/14743/tiktok+ads+library+api+-+ad+creatives+and+advertisers/38169/search+tiktok+ads+library+ads+with+query+parameters
输入参数

搜索TikTok广告库广告并使用查询参数 — 端点功能

对象 描述
search 可选 Advertiser name or keyword (e.g. "nike", "korean skincare"). One of search / ad_id / adv_biz_ids is required.
ad_id 可选 Look up one ad by its ID. This short-circuits the whole run: nothing is fetched from TikTok and the search query, region, dates, sort, limit and offset are all ignored. The single row it returns carries the ad id and a deeplink and no ad content, because TikTok publishes no ad-detail API to read it from.
adv_biz_ids 可选 TikTok's own advertiser business ID. It is sent in the search body next to the query, so TikTok narrows on it rather than the rows being filtered here. It does not replace Search query: whatever is in that box is still sent alongside, so clear it if you want the advertiser on its own. One of search, ad_id or this is needed to start a run.
region 必需 ISO country code or 'all'. Note: TikTok Ad Library does NOT support region=US - use 'all' to include US ads in the global result set.
query_type 必需 1 = by advertiser name, 0 = by keyword.
sort 必需 Order results by recency or impression count.
ad_status 必需 Stopped creative is a record of what an advertiser tried and dropped, and it is usually the larger half. Measured on one Dutch retailer: 12 ads running against 681 stopped.
only_total 可选 Return one row with how many ads match and no ads at all. Costs one request and no per-ad charge. TikTok caps the reported figure at 5000, and the row says whether the number is exact or a floor.
start_date 可选 Lower bound of the search window, written YYYY-MM-DD. It becomes the start_time parameter on TikTok's own search call, so TikTok applies it and a narrower window means fewer pages to walk. Left empty it defaults to one year before the run. An Ad ID lookup ignores it.
end_date 可选 Upper bound of the search window, written YYYY-MM-DD. Like the lower bound it is sent as a parameter on TikTok's own search call rather than applied to the rows afterwards. Left empty it defaults to the moment the run starts, and an Ad ID lookup ignores it.
limit 必需 How many ads to collect. TikTok serves 12 per response, so higher values walk the cursor further and take longer.
offset 必需 Result offset for pagination.
search_id 可选 Continue a previous run from the `_next_search_id` value it wrote on its rows, paired with the Pagination offset from the same rows. The API already walks the cursor by itself up to Number of ads, so this is only for going past where an earlier run stopped, not for reaching a higher count in one go. Leave empty to start a fresh search.
cursor 可选 Signed continuation from next_cursor. Keep search filters unchanged.

剩余免费测试请求:3 / 3。


输入参数

search
ad_id
adv_biz_ids
region
query_type
sort
ad_status
only_total
start_date
end_date
limit
offset
search_id
cursor
API 示例响应
JSON
{
    "items": [
        {
            "ad_id": "1877308015260690",
            "advertiser_name": "Coolblue B.V.",
            "audit_status": "approved",
            "ad_type": "video",
            "first_shown": "2026-09-27",
            "last_shown": "2026-09-30",
            "days_shown": 4,
            "estimated_audience": "100K-200K",
            "impression": 0,
            "spent": "",
            "deeplink": "https://library.tiktok.com/ads/detail/?ad_id=1877308015260690",
            "result_type": "ad",
            "_type": "ad_creative",
            "fetched_at": "2026-10-02T05:19:27.722Z",
            "ad_text": "Ga aan de slag als bezorger bij Coolblue en verdien een goed salaris.",
            "source": "tiktok-ads-library",
            "platform": "tiktok",
            "videos": [
                {
                    "video_url": "https://library.tiktok.com/api/v1/cdn/1790918374/video/aHR0cHM6Ly92NzcudGlrdG9rY2RuLmNvbS85OGI2NWQyNWJkYTY3ZDJiYzk0MmZjYjdjMTY5M2I2Yy82YWJmOTM2MS92aWRlby90b3...",
                    "cover_image": "https://p19-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/o8CNAqkaZWtebGaGQVQM4G84g6fUAhEJDgpjfb~tplv-tiktokx-origin.jpeg?dr=14582&refresh_token=c23a2b67..."
                }
            ],
            "image_urls": [
                "https://p19-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/o8CNAqkaZWtebGaGQVQM4G84g6fUAhEJDgpjfb~tplv-tiktokx-origin.jpeg?dr=14582&refresh_token=c23a2b67..."
            ],
            "creative_id": "1877308015260690",
            "format": "video",
            "first_seen": "2026-09-27",
            "last_seen": "2026-09-30",
            "days_active": 4,
            "text": "Ga aan de slag als bezorger bij Coolblue en verdien een goed salaris.",
            "image_url": "https://p19-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/o8CNAqkaZWtebGaGQVQM4G84g6fUAhEJDgpjfb~tplv-tiktokx-origin.jpeg?dr=14582&refresh_token=c23a2b67...",
            "video_url": "https://library.tiktok.com/api/v1/cdn/1790918374/video/aHR0cHM6Ly92NzcudGlrdG9rY2RuLmNvbS85OGI2NWQyNWJkYTY3ZDJiYzk0MmZjYjdjMTY5M2I2Yy82YWJmOTM2MS92aWRlby90b3...",
            "query": "coolblue",
            "region": "NL",
            "sort": "last_shown_date,desc",
            "ad_status": "active",
            "region_code": "NL",
            "total_ads_in_search": 36,
            "pages_fetched": 3,
            "_next_search_id": "eyJsYXN0X3NvcnQiOlsyMy45NDAzOSwxNzkwNzI2NDAwMDAwXSwibmV4dF9jdXJzb3IiOjMwfQ==",
            "_next_offset": 30
        },
        {
            "ad_id": "1876600152606898",
            "advertiser_name": "Coolblue B.V.",
            "audit_status": "approved",
            "ad_type": "video",
            "first_shown": "2026-09-21",
            "last_shown": "2026-09-30",
            "days_shown": 10,
            "estimated_audience": "10K-100K",
            "impression": 0,
            "spent": "",
            "deeplink": "https://library.tiktok.com/ads/detail/?ad_id=1876600152606898",
            "result_type": "ad",
            "_type": "ad_creative",
            "fetched_at": "2026-10-02T05:19:27.722Z",
            "ad_text": "Kom werken in ons Pakketpark in Tilburg.",
            "source": "tiktok-ads-library",
            "platform": "tiktok",
            "videos": [
                {
                    "video_url": "https://library.tiktok.com/api/v1/cdn/1790918374/video/aHR0cHM6Ly92NzcudGlrdG9rY2RuLmNvbS80NzllODlmMTU2ZDg5ZDc2YjYxNTI5OTc3YjM2YjA2OS82YWJmOTM1ZC92aWRlby90b3...",
                    "cover_image": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/oQeEp9yIBebTAIhEKCLVAFCGAAghODGleCCGPc~tplv-tiktokx-origin.jpeg?dr=14582&refresh_token=4e6f40b0..."
                }
            ],
            "image_urls": [
                "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/oQeEp9yIBebTAIhEKCLVAFCGAAghODGleCCGPc~tplv-tiktokx-origin.jpeg?dr=14582&refresh_token=4e6f40b0..."
            ],
            "creative_id": "1876600152606898",
            "format": "video",
            "first_seen": "2026-09-21",
            "last_seen": "2026-09-30",
            "days_active": 10,
            "text": "Kom werken in ons Pakketpark in Tilburg.",
            "image_url": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/oQeEp9yIBebTAIhEKCLVAFCGAAghODGleCCGPc~tplv-tiktokx-origin.jpeg?dr=14582&refresh_token=4e6f40b0...",
            "video_url": "https://library.tiktok.com/api/v1/cdn/1790918374/video/aHR0cHM6Ly92NzcudGlrdG9rY2RuLmNvbS80NzllODlmMTU2ZDg5ZDc2YjYxNTI5OTc3YjM2YjA2OS82YWJmOTM1ZC92aWRlby90b3...",
            "query": "coolblue",
            "region": "NL",
            "sort": "last_shown_date,desc",
            "ad_status": "active",
            "region_code": "NL",
            "total_ads_in_search": 36,
            "pages_fetched": 3,
            "_next_search_id": "eyJsYXN0X3NvcnQiOlsyMy45NDAzOSwxNzkwNzI2NDAwMDAwXSwibmV4dF9jdXJzb3IiOjMwfQ==",
            "_next_offset": 30
        }
    ],
    "billing": {
        "scraped": 30
    },
    "next_cursor": "eyJ2ZXJzaW9uIjoxLCJmaWx0ZXJzIjoiW1wiY29vbGJsdWVcIixcIlwiLFwiTkxcIixcIjFcIixcImxhc3Rfc2hvd25fZGF0ZSxkZXNjXCIsXCJhY3RpdmVcIixcIlwiLFwiXCJdIiwic3RhcnRfdGltZSI6M...",
    "partial": true,
    "warnings": [
        "More ads remain; continue with next_cursor."
    ],
    "errors": []
}
搜索TikTok广告库广告并使用查询参数 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14743/tiktok+ads+library+api+-+ad+creatives+and+advertisers/38169/search+tiktok+ads+library+ads+with+query+parameters?region=all&query_type=1&sort=last_shown_date,desc&ad_status=active&limit=20&offset=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
通过关键词或广告主搜索抖音广告库广告
Endpoint ID: 38170
POST https://zylalabs.com/api/14743/tiktok+ads+library+api+-+ad+creatives+and+advertisers/38170/search+tiktok+ads+library+ads+by+keyword+or+advertiser
输入参数

通过关键词或广告主搜索 TikTok 广告库广告 — 端点功能

对象 描述
请求体 必需 Json

剩余免费测试请求:3 / 3。


输入参数

API 示例响应
JSON
{
    "items": [
        {
            "ad_id": "1877308015260690",
            "advertiser_name": "Coolblue B.V.",
            "audit_status": "approved",
            "ad_type": "video",
            "first_shown": "2026-09-27",
            "last_shown": "2026-09-30",
            "days_shown": 4,
            "estimated_audience": "100K-200K",
            "impression": 0,
            "spent": "",
            "deeplink": "https://library.tiktok.com/ads/detail/?ad_id=1877308015260690",
            "result_type": "ad",
            "_type": "ad_creative",
            "fetched_at": "2026-10-02T05:19:27.722Z",
            "ad_text": "Ga aan de slag als bezorger bij Coolblue en verdien een goed salaris.",
            "source": "tiktok-ads-library",
            "platform": "tiktok",
            "videos": [
                {
                    "video_url": "https://library.tiktok.com/api/v1/cdn/1790918374/video/aHR0cHM6Ly92NzcudGlrdG9rY2RuLmNvbS85OGI2NWQyNWJkYTY3ZDJiYzk0MmZjYjdjMTY5M2I2Yy82YWJmOTM2MS92aWRlby90b3...",
                    "cover_image": "https://p19-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/o8CNAqkaZWtebGaGQVQM4G84g6fUAhEJDgpjfb~tplv-tiktokx-origin.jpeg?dr=14582&refresh_token=c23a2b67..."
                }
            ],
            "image_urls": [
                "https://p19-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/o8CNAqkaZWtebGaGQVQM4G84g6fUAhEJDgpjfb~tplv-tiktokx-origin.jpeg?dr=14582&refresh_token=c23a2b67..."
            ],
            "creative_id": "1877308015260690",
            "format": "video",
            "first_seen": "2026-09-27",
            "last_seen": "2026-09-30",
            "days_active": 4,
            "text": "Ga aan de slag als bezorger bij Coolblue en verdien een goed salaris.",
            "image_url": "https://p19-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/o8CNAqkaZWtebGaGQVQM4G84g6fUAhEJDgpjfb~tplv-tiktokx-origin.jpeg?dr=14582&refresh_token=c23a2b67...",
            "video_url": "https://library.tiktok.com/api/v1/cdn/1790918374/video/aHR0cHM6Ly92NzcudGlrdG9rY2RuLmNvbS85OGI2NWQyNWJkYTY3ZDJiYzk0MmZjYjdjMTY5M2I2Yy82YWJmOTM2MS92aWRlby90b3...",
            "query": "coolblue",
            "region": "NL",
            "sort": "last_shown_date,desc",
            "ad_status": "active",
            "region_code": "NL",
            "total_ads_in_search": 36,
            "pages_fetched": 3,
            "_next_search_id": "eyJsYXN0X3NvcnQiOlsyMy45NDAzOSwxNzkwNzI2NDAwMDAwXSwibmV4dF9jdXJzb3IiOjMwfQ==",
            "_next_offset": 30
        },
        {
            "ad_id": "1876600152606898",
            "advertiser_name": "Coolblue B.V.",
            "audit_status": "approved",
            "ad_type": "video",
            "first_shown": "2026-09-21",
            "last_shown": "2026-09-30",
            "days_shown": 10,
            "estimated_audience": "10K-100K",
            "impression": 0,
            "spent": "",
            "deeplink": "https://library.tiktok.com/ads/detail/?ad_id=1876600152606898",
            "result_type": "ad",
            "_type": "ad_creative",
            "fetched_at": "2026-10-02T05:19:27.722Z",
            "ad_text": "Kom werken in ons Pakketpark in Tilburg.",
            "source": "tiktok-ads-library",
            "platform": "tiktok",
            "videos": [
                {
                    "video_url": "https://library.tiktok.com/api/v1/cdn/1790918374/video/aHR0cHM6Ly92NzcudGlrdG9rY2RuLmNvbS80NzllODlmMTU2ZDg5ZDc2YjYxNTI5OTc3YjM2YjA2OS82YWJmOTM1ZC92aWRlby90b3...",
                    "cover_image": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/oQeEp9yIBebTAIhEKCLVAFCGAAghODGleCCGPc~tplv-tiktokx-origin.jpeg?dr=14582&refresh_token=4e6f40b0..."
                }
            ],
            "image_urls": [
                "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/oQeEp9yIBebTAIhEKCLVAFCGAAghODGleCCGPc~tplv-tiktokx-origin.jpeg?dr=14582&refresh_token=4e6f40b0..."
            ],
            "creative_id": "1876600152606898",
            "format": "video",
            "first_seen": "2026-09-21",
            "last_seen": "2026-09-30",
            "days_active": 10,
            "text": "Kom werken in ons Pakketpark in Tilburg.",
            "image_url": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/oQeEp9yIBebTAIhEKCLVAFCGAAghODGleCCGPc~tplv-tiktokx-origin.jpeg?dr=14582&refresh_token=4e6f40b0...",
            "video_url": "https://library.tiktok.com/api/v1/cdn/1790918374/video/aHR0cHM6Ly92NzcudGlrdG9rY2RuLmNvbS80NzllODlmMTU2ZDg5ZDc2YjYxNTI5OTc3YjM2YjA2OS82YWJmOTM1ZC92aWRlby90b3...",
            "query": "coolblue",
            "region": "NL",
            "sort": "last_shown_date,desc",
            "ad_status": "active",
            "region_code": "NL",
            "total_ads_in_search": 36,
            "pages_fetched": 3,
            "_next_search_id": "eyJsYXN0X3NvcnQiOlsyMy45NDAzOSwxNzkwNzI2NDAwMDAwXSwibmV4dF9jdXJzb3IiOjMwfQ==",
            "_next_offset": 30
        }
    ],
    "billing": {
        "scraped": 30
    },
    "next_cursor": "eyJ2ZXJzaW9uIjoxLCJmaWx0ZXJzIjoiW1wiY29vbGJsdWVcIixcIlwiLFwiTkxcIixcIjFcIixcImxhc3Rfc2hvd25fZGF0ZSxkZXNjXCIsXCJhY3RpdmVcIixcIlwiLFwiXCJdIiwic3RhcnRfdGltZSI6M...",
    "partial": true,
    "warnings": [
        "More ads remain; continue with next_cursor."
    ],
    "errors": []
}
通过关键词或广告主搜索 TikTok 广告库广告 — 代码片段

curl --location --request POST 'https://zylalabs.com/api/14743/tiktok+ads+library+api+-+ad+creatives+and+advertisers/38170/search+tiktok+ads+library+ads+by+keyword+or+advertiser' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{"search":"coolblue","region":"NL","limit":30}'

    

API 访问密钥和身份验证

注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 抖音广告库API - 广告创意和广告主 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。

标头
标头 描述
授权 必需 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。

无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。

起价
$10,000/年


  • 自定义数量
  • 自定义速率限制
  • 专业客户支持
  • 实时 API 监控

概览

通过关键词、广告主或广告 ID 搜索公共 TikTok 广告库:广告主、广告文本、媒体 URL、首次和最后展示日期、地区和状态。限制:每次调用最多返回 25 个广告

抖音广告库API - 广告创意和广告主 API FAQs

每个端点返回与TikTok广告相关的数据,包括广告ID 广告主名称 广告文本 媒体URL 首次和最后展示日期 估计受众和审核状态 数据采用JSON格式结构化 提供关于每个广告表现和特征的详细洞察

响应数据中的关键字段包括 `ad_id`、`advertiser_name`、`ad_text`、`first_shown`、`last_shown`、`estimated_audience` 和 `videos` 这些字段提供了关于广告的身份、内容和可见性的基本信息

用户可以使用 `keyword`、`advertiser` 和 `ad_id` 等参数自定义数据请求 这些参数允许在 TikTok 广告库中进行有针对性的搜索 让用户能够根据自己的兴趣找到特定的广告

响应数据以JSON结构组织,`items`键下有一个项的数组。每个项代表一个广告,并包含各种字段详细说明广告的属性,便于程序解析和使用

数据直接来源于公开的TikTok广告库,确保反映平台上最新和相关的广告内容。这有助于维护数据的完整性和相关性。

典型的使用案例包括市场研究、竞争分析和广告效果跟踪 营销人员可以分析趋势、了解竞争对手的策略以及评估不同广告格式和信息的有效性

用户可以通过分析广告绩效指标 比较不同的广告主 并识别成功的广告策略 来利用返回的数据 详细的字段提供了深入了解受众参与度和广告有效性的机会

如果结果是部分的或为空,用户应检查其查询参数的准确性或扩大搜索条件。实现分页也可以帮助检索到更多的广告,如果初始请求返回的结果少于预期。

一般常见问题

Zyla API Hub 就像一个大型 API 商店,您可以在一个地方找到数千个 API。我们还为所有 API 提供专门支持和实时监控。注册后,您可以选择要使用的 API。请记住,每个 API 都需要自己的订阅。但如果您订阅多个 API,您将为所有这些 API 使用相同的密钥,使事情变得更简单。
价格以 USD(美元)、EUR(欧元)、CAD(加元)、AUD(澳元)和 GBP(英镑)列出。我们接受所有主要的借记卡和信用卡。我们的支付系统使用最新的安全技术,由 Stripe 提供支持,Stripe 是世界上最可靠的支付公司之一。如果您在使用卡片付款时遇到任何问题,请通过 [email protected]

此外,如果您已经以这些货币中的任何一种(USD、EUR、CAD、AUD、GBP)拥有有效订阅,该货币将保留用于后续订阅。只要您没有任何有效订阅,您可以随时更改货币。
定价页面上显示的本地货币基于您 IP 地址的国家/地区,仅供参考。实际价格以 USD(美元)为单位。当您付款时,即使您在我们的网站上看到以本地货币显示的等值金额,您的卡片对账单上也会以美元显示费用。这意味着您不能直接使用本地货币付款。
有时,银行可能会因其欺诈保护设置而拒绝收费。我们建议您首先联系您的银行,检查他们是否阻止了我们的收费。此外,您可以访问账单门户并更改关联的卡片以进行付款。如果这些方法不起作用并且您需要进一步帮助,请通过 [email protected]
价格由月度或年度订阅决定,具体取决于所选计划。
API 调用根据成功请求从您的计划中扣除。每个计划都包含您每月可以进行的特定数量的调用。只有成功的调用(由状态 200 响应指示)才会计入您的总数。这确保失败或不完整的请求不会影响您的月度配额。
Zyla API Hub 采用月度订阅系统。您的计费周期将从您购买付费计划的那一天开始,并在下个月的同一日期续订。因此,如果您想避免未来的费用,请提前取消订阅。
要升级您当前的订阅计划,只需转到 API 的定价页面并选择您要升级到的计划。升级将立即生效,让您立即享受新计划的功能。请注意,您之前计划中的任何剩余调用都不会转移到新计划,因此在升级时请注意这一点。您将被收取新计划的全部金额。
要检查您本月剩余多少 API 调用,请参考响应标头中的 "X-Zyla-API-Calls-Monthly-Remaining" 字段。例如,如果您的计划允许每月 1,000 个请求,而您已使用 100 个,则响应标头中的此字段将显示 900 个剩余调用。
要查看您的计划允许的最大 API 请求数,请检查 "X-Zyla-RateLimit-Limit" 响应标头。例如,如果您的计划包括每月 1,000 个请求,此标头将显示 1,000。
"X-Zyla-RateLimit-Reset" 标头显示您的速率限制重置之前的秒数。这告诉您何时您的请求计数将重新开始。例如,如果它显示 3,600,则意味着还有 3,600 秒直到限制重置。
是的,您可以随时通过访问您的账户并在账单页面上选择取消选项来取消您的计划。请注意,升级、降级和取消会立即生效。此外,取消后,您将不再有权访问该服务,即使您的配额中还有剩余调用。
为了让您有机会在没有任何承诺的情况下体验我们的 API,我们提供 7 天免费试用,允许您免费进行最多 50 次 API 调用。此试用只能使用一次,因此我们建议将其应用于您最感兴趣的 API。虽然我们的大多数 API 都提供免费试用,但有些可能不提供。试用在 7 天后或您进行了 50 次请求后结束,以先发生者为准。如果您在试用期间达到 50 次请求限制,您需要"开始您的付费计划"以继续发出请求。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。或者,如果您在第 7 天之前不取消订阅,您的免费试用将结束,您的计划将自动计费,授予您访问计划中指定的所有 API 调用的权限。请记住这一点以避免不必要的费用。
7 天后,您将被收取试用期间订阅的计划的全额费用。因此,在试用期结束前取消很重要。因忘记及时取消而提出的退款请求不被接受。
当您订阅 API 免费试用时,您可以进行最多 50 次 API 调用。如果您希望超出此限制进行额外的 API 调用,API 将提示您执行"开始您的付费计划"。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。
付款订单在每月 20 日至 30 日之间处理。如果您在 20 日之前提交请求,您的付款将在此时间范围内处理。
您可以通过我们的聊天渠道联系我们以获得即时帮助。我们始终在线,时间为上午 8 点至下午 5 点(EST)。如果您在该时间之后联系我们,我们将尽快回复您。此外,您可以通过 [email protected]

相关 API