Pricing

from $1.00 / 1,000 results

TikTok Ads Library Scraper Pro

Scrape TikTok's public ad transparency library by query, advertiser, region, and date range. Pulls ad text, video URL, advertiser, impression buckets, and per-region/age/gender targeting. Pro filters: regionFilter, industryFilter, minImpressions, daysActive derived field.

Pricing

from $1.00 / 1,000 results

Rating

0.0

(0)

Developer

Crawler Bros

Actor stats

Bookmarked

Total users

Monthly active users

6 days ago

Last modified

Categories

Social media

Developer tools

Other

You can access the TikTok Ads Library Scraper Pro programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "1.0",
    "x-build-id": "3b4q30MbLhJ77MC0M"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/crawlerbros~tiktok-ads-library-scraper-pro/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-crawlerbros-tiktok-ads-library-scraper-pro",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/crawlerbros~tiktok-ads-library-scraper-pro/runs": {
      "post": {
        "operationId": "runs-sync-crawlerbros-tiktok-ads-library-scraper-pro",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/crawlerbros~tiktok-ads-library-scraper-pro/run-sync": {
      "post": {
        "operationId": "run-sync-crawlerbros-tiktok-ads-library-scraper-pro",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": {
            "title": "Search query",
            "type": "string",
            "description": "Free-text query — company name, domain, or ad text. Leave empty to browse all recent ads.",
            "default": ""
          },
          "adIds": {
            "title": "Ad IDs (direct lookup)",
            "type": "array",
            "description": "Direct list of TikTok ad IDs. Bypasses search and fetches each ad's detail page directly.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "advertiserName": {
            "title": "Advertiser name",
            "type": "string",
            "description": "Filter by advertiser name (substring match)."
          },
          "region": {
            "title": "Region",
            "enum": [
              "all",
              "AT",
              "BE",
              "BG",
              "CH",
              "CY",
              "CZ",
              "DE",
              "DK",
              "EE",
              "ES",
              "FI",
              "FR",
              "GB",
              "GR",
              "HR",
              "HU",
              "IE",
              "IS",
              "IT",
              "LI",
              "LT",
              "LU",
              "LV",
              "MT",
              "NL",
              "NO",
              "PL",
              "PT",
              "RO",
              "SE",
              "SI",
              "SK",
              "TR"
            ],
            "type": "string",
            "description": "TikTok ad region. The library covers EU/EEA + UK/CH/TR (DSA transparency). Use `all` for all-region search.",
            "default": "all"
          },
          "startDate": {
            "title": "Start date (YYYY-MM-DD)",
            "type": "string",
            "description": "Earliest ad start date. Default: 1 year ago."
          },
          "endDate": {
            "title": "End date (YYYY-MM-DD)",
            "type": "string",
            "description": "Latest ad end date. Default: today."
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "last_shown_date,desc",
              "last_shown_date,asc",
              "create_time,desc",
              "create_time,asc",
              "impression,desc",
              "impression,asc"
            ],
            "type": "string",
            "description": "How to sort results.",
            "default": "last_shown_date,desc"
          },
          "quickSearch": {
            "title": "Quick search (skip detail pages)",
            "type": "boolean",
            "description": "When true, skip the ad-detail fetch and only return data from the listing card. Faster but omits some fields (full targeting breakdown).",
            "default": true
          },
          "maxItems": {
            "title": "Max items",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Hard cap on emitted ads.",
            "default": 10
          },
          "regionFilter": {
            "title": "Region filter (Pro)",
            "type": "array",
            "description": "Only emit ads that target one of these regions. Case-insensitive substring match against `targetingByLocation`.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "minImpressions": {
            "title": "Min impressions (Pro)",
            "minimum": 0,
            "maximum": 1000000000,
            "type": "integer",
            "description": "Drop ads with fewer than this many impressions (numeric value parsed from TikTok's bucket like `10K-100K`)."
          },
          "industryFilter": {
            "title": "Industry filter (Pro)",
            "type": "array",
            "description": "Only emit ads whose advertiser industry contains one of these substrings.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "languageFilter": {
            "title": "Language filter (Pro)",
            "type": "array",
            "description": "Only emit ads in these languages (matched case-insensitively against the `adLanguages` field, e.g. `en`, `de`, `fr`). Ads without a detected language are kept. Most effective with `quickSearch=false`.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "ctaFilter": {
            "title": "CTA filter (Pro)",
            "type": "array",
            "description": "Only emit ads whose call-to-action button text contains one of these substrings (case-insensitive — e.g. `Shop Now`, `Learn More`, `Sign Up`). Ads without a CTA are dropped. Requires `quickSearch=false` — CTA data is only available from the detail page.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "useApifyProxy": {
            "title": "Use Apify proxy",
            "type": "boolean",
            "description": "Route requests through Apify's proxy pool (datacenter EU exit IPs). Recommended on cloud — avoids IP rate-limiting. The actor automatically rotates the proxy session on errors.",
            "default": true
          },
          "requestDelaySecs": {
            "title": "Delay between requests (seconds)",
            "minimum": 0,
            "maximum": 10,
            "type": "integer",
            "description": "Pause between successive API calls. Lower = faster runs but more rate-limit risk; higher = slower but more reliable. The actor still adds short backoff between retries automatically.",
            "default": 1
          },
          "timezone": {
            "title": "Timezone",
            "enum": [
              "UTC",
              "Europe/London",
              "Europe/Berlin",
              "Europe/Paris",
              "Europe/Madrid",
              "Europe/Rome",
              "Europe/Amsterdam",
              "Europe/Stockholm",
              "Europe/Warsaw",
              "Europe/Athens",
              "Europe/Istanbul",
              "Europe/Moscow",
              "Asia/Dubai",
              "Asia/Tokyo",
              "Asia/Shanghai",
              "Asia/Singapore",
              "Asia/Kolkata",
              "Australia/Sydney",
              "America/New_York",
              "America/Chicago",
              "America/Denver",
              "America/Los_Angeles",
              "America/Sao_Paulo",
              "America/Mexico_City"
            ],
            "type": "string",
            "description": "IANA timezone for date-range bucketing (`startDate`/`endDate`). Default UTC.",
            "default": "UTC"
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

TikTok Ads Library Scraper Pro OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for TikTok Ads Library Scraper Pro from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

TikTok Ads Library Scraper Pro API in Python

TikTok Ads Library Scraper Pro API in JavaScript

TikTok Ads Library Scraper Pro API through CLI

TikTok Ads Library Scraper Pro API

TikTok Ads Library Scraper - Ad Spy

elliotpadfield/tiktok-ads-library-scraper

Scrape TikTok Commercial Content Library ads by keyword, advertiser, business ID, country, date range, or ad URL. Extract creatives, video URLs, targeting, reach buckets, sponsors, and advertiser metadata.

Elliot Padfield

Pinterest Ad Library API - Ad Transparency Scraper

dev00/pinterest-ad-library-api-ad-transparency-scraper

Access Pinterest's Ad Transparency Library. Search for advertiser names, retrieve active ads by country, categories, age range, or gender, and query specific ad creative details.

dev00

TikTok Ads Library Scraper

codingfrontend/tiktok-ads-library-scraper

Scrapes TikTok Ads Library (library.TikTok.com/ads) for ad creatives, advertiser details, engagement metrics, and video URLs.

Coding Frontned

TikTok Ads Library Scraper

prodiger/tiktok-ads-library-scraper

Scrape TikTok's Ad Library by keyword, advertiser name, or business ID across supported regions.

Arnas

Facebook Ad Library Scraper

akash9078/facebook-ad-library-scraper

Scrape Facebook Ad Library data including ad creatives, targeting info, performance metrics, and advertiser details. Extract ads by keyword, advertiser, or country for competitive research and marketing analysis.

Akash Kumar Naik

TikTok Ad Library Scraper

rastriq/tiktok-ad-library-scraper

Scrape the TikTok Commercial Content Library for ad creatives, advertiser info, and campaign metadata. Monitor competitor ad strategies on TikTok.

Rastriq — Structured data from the world

Tiktok Ad Library Scraper

ivanvs/tiktok-ad-library-scraper

Extract details about ads from TikTok Ad Library. Scrape ad details like when it was run, ad targeting, advertiser and content of ad. Download ad data in JSON, XML, Excel format.

Gen First

227

TikTok Ads Library Scraper

s-r/tiktok-ads-library

Scrape TikTok's Ad Library by keyword, advertiser name, or business ID across any region — get video URLs, cover images, impressions, spend, dates, and rejection info.

Facebook Ad Library Scraper

lentic_clockss/facebook-ad-library-scraper

Scrape Facebook Ad Library for ad creatives, spend data, advertiser info, and targeting. Search any keyword, advertiser, or country. No login needed — fully public data.

kane liu

TikTok Ad Library - Free To Use

dz_omar/tiktok-ad-library-scraper

Scrape ads from the TikTok Ad Library by keyword, advertiser name, or URL. Export advertiser details, creatives, first/last shown dates, audience size, targeting data, and permanently download media files. No login required. ♾️ Unlimited results.