{"openapi":"3.1.0","info":{"title":"Scrape Creators API","description":"The easiest way to scrape public social media data at scale. Extract profiles, posts, videos, comments, and more from TikTok, Instagram, YouTube, Twitter, LinkedIn, Facebook, Reddit, and 27+ platforms.","version":"1.0.0","contact":{"name":"Scrape Creators","url":"https://scrapecreators.com","email":"support@scrapecreators.com"}},"servers":[{"url":"https://api.scrapecreators.com","description":"Production server"}],"security":[{"apiKeyAuth":[]}],"tags":[{"name":"TikTok Ad Library","description":"Scrape the TikTok Ad Library"}],"paths":{"/v1/tiktok/ad-library/search":{"get":{"tags":["TikTok Ad Library"],"summary":"Ad Library Search","description":"Searches TikTok Creative Center Top Ads, the ad library page at ads.tiktok.com/business/creativecenter/inspiration/topads. Supports US and other 2-letter regions, period filters, sorting, keyword search, and cursor pagination. Returns TikTok's public top ad material objects, including ad title, metrics, video info, landing page, and pagination.","parameters":[{"name":"region","in":"query","required":false,"description":"Country code. Defaults to US.","schema":{"type":"string","enum":["DZ","AR","AU","AT","AZ","BH","BD","BY","BE","BO","BR","BG","KH","CA","CL","CO","CR","HR","CY","CZ","DK","DO","EC","EG","EE","FI","FR","DE","GR","GT","JO","HU","ID","IQ","IE","IL","IT","JP","KZ","KE","KW","LV","LB","MY","MX","MA","NL","NZ","NG","NO","OM","PK","PA","PY","PE","PH","PL","PT","PR","QA","LT","RO","SA","RS","SG","SK","SI","ZA","KR","ES","LK","SE","CH","TW","TH","TR","AE","GB","US","UY","VN"]},"example":"US"},{"name":"period","in":"query","required":false,"description":"Time window for Top Ads.","schema":{"type":"string","enum":["7","30","180"]},"example":"30"},{"name":"query","in":"query","required":false,"description":"Optional keyword to search ad titles/content.","schema":{"type":"string"},"example":"spotify"},{"name":"order_by","in":"query","required":false,"description":"Sort metric. Defaults to for_you.","schema":{"type":"string","enum":["for_you","impression","play_2s_rate","play_6s_rate","cvr","ctr","like"]},"example":"for_you"},{"name":"industry","in":"query","required":false,"description":"Industry filter.","schema":{"type":"string","enum":["apparel_accessories","appliances","apps","baby_kids_maternity","beauty_personal_care","business_services","ecommerce_non_app","education","financial_services","food_beverage","games","health","home_improvement","household_products","life_services","news_entertainment","pets","sports_outdoor","tech_electronics","travel","vehicle_transportation"]},"example":"beauty_personal_care"},{"name":"objective","in":"query","required":false,"description":"Campaign objective filter.","schema":{"type":"string","enum":["app_installs","conversions","lead_generation","product_sales","reach","traffic","video_views"]},"example":"traffic"},{"name":"duration","in":"query","required":false,"description":"Video duration filter.","schema":{"type":"string","enum":["under_10s","10_20s","20_30s","30_40s","40_50s","over_50s"]},"example":"under_10s"},{"name":"likes","in":"query","required":false,"description":"Likes percentile filter.","schema":{"type":"string","enum":["top_1_20","top_21_40","top_41_60","top_61_80","top_81_100"]},"example":"top_1_20"},{"name":"ad_format","in":"query","required":false,"description":"Ad format filter.","schema":{"type":"string","enum":["spark_ads","non_spark_ads"]},"example":"spark_ads"},{"name":"ad_language","in":"query","required":false,"description":"Ad language filter.","schema":{"type":"string","enum":["en","es","ar","vi","th","de","id","pt","fr","ms","nl","ja","it","ro","zh-Hant","ko"]},"example":"en"},{"name":"cursor","in":"query","required":false,"description":"Page number to fetch. Use the cursor returned from the previous response, like 3 for page 3.","schema":{"type":"number"},"example":"3"},{"name":"limit","in":"query","required":false,"description":"Number of ads to return, max 50. Defaults to 20.","schema":{"type":"number"},"example":"20"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"success":true,"credits_remaining":49996315011,"query":"","region":"US","period":30,"ads":[{"ad_title":"I thought this was a gimmick until I tried it! A wrinkled shirt, one button, and a few minutes later... ready to wear. Tap the link in bio and see why everyone’s talking about Bellairon before it sells out. @Bellairon LLC ","brand_name":"","cost":1,"ctr":0.5,"favorite":false,"id":"7646829987799334920","industry_key":"label_22108000000","is_search":true,"like":92,"objective_key":"campaign_objective_reach","video_info":{"vid":"v12044gd0000d8erq07og65h1cq991gg","duration":89.767,"cover":"https://p16-common-sign.tiktokcdn.com/tos-maliva-p-0068c799-us/oIbqBdvfEAiFpgvAOgrQHCF5R0mkDDLiEfvQDS~tplv-noop.image?dr=18692&refresh_token=2ac068a9&x-expires=1781231816&x-signature=hLbBkguntM4oX9tgdnKMMDYixAA%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=317596d8&idc=my2&VideoID=v12044gd0000d8erq07og65h1cq991gg","video_url":{"540p":"https://v16m-default.tiktokcdn.com/64e64ad32f68588eee511da0114f0f2e/6a2b70c8/video/tos/maliva/tos-maliva-ve-0068c799-us/oIN2GPIRgHAUBHOeNfLk2HBSERoJeIALGC3jAE/?a=0&bti=NTU4QDM1NGA%3D&&bt=315&ft=cApXJCz7ThWHK-z9LGZmo0P&mime_type=video_mp4&rc=Omk6ZWQ7Nzc7OGY8PGVnOkBpajQ8Zms5cjN1OzMzZzczNEBgNDAzXl9hXjMxLzEvXjFiYSNkNm4uMmQ0bmJhLS1kMS9zcw%3D%3D&vvpl=1&l=20260612043527C18C959B9A8CF584D398&btag=e00090000","720p":"https://v16m-default.tiktokcdn.com/4ee4e5763b088d7d77e4a9f4fce502b6/6a2b70c8/video/tos/maliva/tos-maliva-ve-0068c799-us/ooEipQa9HbhJ4ChzASIngUPhBAdXiABIvxU2E/?a=0&bti=NTU4QDM1NGA%3D&&bt=877&ft=cApXJCz7ThWHK-z9LGZmo0P&mime_type=video_mp4&rc=ZTg3OTQ0NTQzZGVpNWg6NkBpajQ8Zms5cjN1OzMzZzczNEBhNC0yMDViNi8xLV9hX2AuYSNkNm4uMmQ0bmJhLS1kMS9zcw%3D%3D&vvpl=1&l=20260612043527C18C959B9A8CF584D398&btag=e00090000"},"width":720,"height":1280}}],"pagination":{"has_more":true,"page":1,"size":20,"total_count":326},"total":326,"has_more":true,"cursor":2}}}}}}}},"components":{"securitySchemes":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"Your Scrape Creators API key"}}}}