# TikTok ad library API for your agent TikTok ad library API for an agent: it sends a keyword or an advertiser name to a catalog endpoint and reads ad video, caption and advertiser back. Several providers sell the call, so the agent tries the cheapest first. You pay per call, and a failed call costs nothing. ## What this does TikTok ads show up in two public places: the Ads Library and the Creative Center, which ranks top ads. Your agent searches both through one call. Send a keyword or an advertiser name and read back the ads with their captions, formats and the engagement they earned. The providers cover different parts. One searches the Ads Library by keyword or advertiser, and resolves the advertiser name before it searches. One lists Creative Center top ads, which are the best-performing auction ads, with filters for format, language, industry and objective. Two others search ads by keyword with a country code. You give: a keyword or an advertiser name. Example: skincare. ## What differs between providers - Scrape Creators API (scrapecreators-tiktok-ad-library-search): searches the Ads Library by keyword or advertiser name, and resolves the name through TikTok's typeahead first. - Adyntel (adyntel-tiktok-search): searches ads by keyword with a country code. - TikHub (tikhub-api-tiktok-ads-search-ads): searches ads with filters for format, language, country, industry, like count and limit, using public data only. - Any Site API (anysite-api-tiktok-creative-center-ads-search): lists Creative Center top ads, the best-performing auction ads, with filters for format, language, industry, objective and period. ## Before you start - Choose between the library and the top-ads list. The library shows what runs. The Creative Center shows what performs. - Name the filters. Industry, ad language, format and country narrow a TikTok search a lot, and the endpoint pages list the values. - Do not send a cookie. One endpoint says to send public data only, and your agent needs no login for any of these. ## Prompt Use looot to search TikTok ads for skincare in the United States and return the advertiser, the caption, the format and the engagement for each ad. 1. Set up https://looot.ai/skill.md. 2. Search the catalog for each step and check its price before you call. 3. Run the cheapest endpoint that fits. 4. Show the results as a table and the total cost. ## Steps and providers - Search TikTok ads: scrapecreators, adyntel, tikhub, anysite. 1 call per search. ## What comes back - Ad video and caption - Advertiser - Ad format and language - Industry - Likes and engagement ## The request and what comes back Each run is one POST to /v1/runs with an endpoint id and an input. These are illustrative calls with generic values. The run's result holds the provider's own fields. - Scrape Creators API: {"endpointId":"scrapecreators-tiktok-ad-library-search","input":{"query":"skincare"},"wait":30} - Adyntel: {"endpointId":"adyntel-tiktok-search","input":{"keyword":"skincare","country_code":"US"},"wait":30} ## What can I learn from the ads? Which hooks, formats and offers advertisers run in a category. Your agent can group the ads by advertiser and list the most common opening lines. ## How do I search TikTok ads? Send a keyword or an advertiser name to a TikTok ad endpoint. Your agent returns the ads with the caption, the format and the advertiser. ## What is the difference between the Ads Library and the Creative Center? The Ads Library lists ads that run. The Creative Center ranks top-performing ads and shows engagement. Two of the providers here read the Creative Center, and the others read the library. ## Can I filter by industry or country? Yes, on the endpoints that support it. They take an industry, an ad language, a format and a country code. The endpoint pages list the accepted values. ## Do I need a TikTok login? No. These endpoints read public data. One page says to send no cookie. ## How much does one search cost? You pay per call, and the price depends on the provider your agent picks. This page reads the cheapest live price from the catalog and shows no number when the catalog is unreachable. ## Do I pay when a tiktok ad library call fails? No. A call that fails at the provider costs nothing, and your agent can retry it or send it to another provider. ## Do I need an account with each tiktok ad library provider? No. One looot key reaches every provider in the catalog. You top up once, and each call is billed at the price shown before it runs. ## How do I call tiktok ad library from code? Send a POST to /v1/runs with the endpoint id, the input and a new idempotency key, and your looot token in the Authorization header. With wait set to 30, the answer comes back in the response when the run ends within 30 seconds. Otherwise poll GET /v1/runs/. ## Can I run tiktok ad library on a schedule? That needs scheduled runs, not available yet. Run it by hand whenever you want fresh results. ## Do I pay while my agent is idle? No. looot bills per call, and nothing runs while your agent is idle. ## Related pages - /use-cases/meta-ads-library-api - /use-cases/tiktok-search-api - /use-cases/tiktok-shop-api ## Last reviewed 2026-10-04. The cost per 1,000 search runs is read live from the catalog on the web page.