{
  "openapi": "3.0.1",
  "info": {
    "title": "TikTok Creative Center Scraper - Top Ads, Hashtags & Trends",
    "description": "Scrape the TikTok Creative Center: search top-performing TikTok ads by keyword, industry, objective and period, get ad details and performance analyses, trending hashtags, videos and search words, music charts and creator search insights. No login or cookies needed. Export JSON, CSV or Excel.",
    "version": "0.1",
    "x-build-id": "cUqKNYTISBO6Em59m"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/clover_folktale~tiktok-creative-center-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-clover_folktale-tiktok-creative-center-scraper",
        "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/clover_folktale~tiktok-creative-center-scraper/runs": {
      "post": {
        "operationId": "runs-sync-clover_folktale-tiktok-creative-center-scraper",
        "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/clover_folktale~tiktok-creative-center-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-clover_folktale-tiktok-creative-center-scraper",
        "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",
        "required": [
          "mode"
        ],
        "properties": {
          "mode": {
            "title": "Mode",
            "enum": [
              "topAds",
              "adDetail",
              "trendingHashtags",
              "trendingVideos",
              "trendingSearches",
              "musicChart",
              "searchInsights",
              "spotlightAds"
            ],
            "type": "string",
            "description": "What to scrape: top ads by keyword (or the top ads for the chosen filters), the details and analyses of single ads, trending hashtags, trending videos, trending search words, the music charts, creator search insights (topics people search for), or the spotlight ads the platform picks (about 5 per run, optionally for one industry).",
            "default": "topAds"
          },
          "keywords": {
            "title": "Keywords (mode: topAds)",
            "type": "array",
            "description": "Search keywords; each keyword is a separate search and pays its own start fee. Leave empty to list the top ads for the chosen filters.",
            "items": {
              "type": "string"
            }
          },
          "adIds": {
            "title": "Ad IDs or links (mode: adDetail)",
            "type": "array",
            "description": "Ad IDs (the adId field of a topAds result) or Creative Center ad links. One start fee per run.",
            "items": {
              "type": "string"
            }
          },
          "country": {
            "title": "Region (modes: trendingHashtags, trendingVideos)",
            "enum": [
              "AR",
              "AU",
              "BR",
              "CA",
              "CO",
              "FR",
              "DE",
              "ID",
              "IT",
              "JP",
              "MY",
              "MX",
              "NL",
              "PK",
              "PH",
              "RO",
              "SA",
              "SG",
              "ZA",
              "KR",
              "ES",
              "SE",
              "TH",
              "TR",
              "AE",
              "GB",
              "US",
              "VN"
            ],
            "type": "string",
            "description": "Region of the ranking. These are the regions the Creative Center offers. Ad search (mode topAds) does not use it: the platform ranks ads across regions.",
            "default": "US"
          },
          "industry": {
            "title": "Industry (modes: topAds, trendingHashtags, spotlightAds)",
            "enum": [
              "10000000000",
              "15000000000",
              "27000000000",
              "22000000000",
              "13000000000",
              "29000000000",
              "12000000000",
              "24000000000",
              "14000000000",
              "19000000000",
              "16000000000",
              "30000000000",
              "25000000000",
              "18000000000",
              "11000000000",
              "28000000000",
              "20000000000",
              "17000000000",
              "23000000000",
              "21000000000",
              "26000000000"
            ],
            "type": "string",
            "description": "Only ads or hashtags of this industry (spotlight ads: only picks of this industry, often just one or none). Leave empty for all industries."
          },
          "subIndustry": {
            "title": "Sub-industry (mode: topAds)",
            "enum": [
              "10100000000",
              "10101000000",
              "10102000000",
              "10103000000",
              "10104000000",
              "10105000000",
              "10106000000",
              "10999000000",
              "11100000000",
              "11101000000",
              "11102000000",
              "11103000000",
              "11104000000",
              "11105000000",
              "11106000000",
              "11107000000",
              "11108000000",
              "11109000000",
              "11110000000",
              "11111000000",
              "11112000000",
              "11999000000",
              "12100000000",
              "12101000000",
              "12102000000",
              "12103000000",
              "12104000000",
              "12105000000",
              "12106000000",
              "12107000000",
              "12108000000",
              "12109000000",
              "12110000000",
              "12999000000",
              "13100000000",
              "13101000000",
              "13102000000",
              "13103000000",
              "13104000000",
              "13105000000",
              "13107000000",
              "13108000000",
              "13109000000",
              "13110000000",
              "13111000000",
              "13112000000",
              "13113000000",
              "13114000000",
              "13115000000",
              "13116000000",
              "13117000000",
              "13999000000",
              "14100000000",
              "14101000000",
              "14102000000",
              "14103000000",
              "14104000000",
              "14105000000",
              "14106000000",
              "14107000000",
              "14999000000",
              "15100000000",
              "15101000000",
              "15102000000",
              "15103000000",
              "15104000000",
              "15105000000",
              "15106000000",
              "15107000000",
              "15999000000",
              "16100000000",
              "16101000000",
              "16102000000",
              "16104000000",
              "16105000000",
              "16999000000",
              "17103000000",
              "17105000000",
              "17106000000",
              "17999000000",
              "18100000000",
              "18101000000",
              "18102000000",
              "18103000000",
              "18104000000",
              "18105000000",
              "18106000000",
              "18107000000",
              "18108000000",
              "18109000000",
              "18110000000",
              "18111000000",
              "18112000000",
              "18999000000",
              "19100000000",
              "19101000000",
              "19102000000",
              "19103000000",
              "19104000000",
              "19105000000",
              "19106000000",
              "19999000000",
              "20100000000",
              "20101000000",
              "20102000000",
              "20103000000",
              "20104000000",
              "20105000000",
              "20106000000",
              "20107000000",
              "20108000000",
              "20109000000",
              "20110000000",
              "20111000000",
              "20112000000",
              "20999000000",
              "21100000000",
              "21101000000",
              "21102000000",
              "21103000000",
              "21104000000",
              "21105000000",
              "21999000000",
              "22101000000",
              "22102000000",
              "22105000000",
              "22106000000",
              "22107000000",
              "22108000000",
              "22109000000",
              "22110000000",
              "22111000000",
              "22112000000",
              "22113000000",
              "22999000000",
              "23100000000",
              "23101000000",
              "23102000000",
              "23103000000",
              "23104000000",
              "23105000000",
              "23106000000",
              "23107000000",
              "23108000000",
              "23109000000",
              "23110000000",
              "23111000000",
              "23112000000",
              "23113000000",
              "23114000000",
              "23115000000",
              "23116000000",
              "23117000000",
              "23118000000",
              "23119000000",
              "23122000000",
              "23123000000",
              "23124000000",
              "23125000000",
              "23126000000",
              "23127000000",
              "23128000000",
              "23129000000",
              "23130000000",
              "23131000000",
              "23132000000",
              "23133000000",
              "23134000000",
              "23999000000",
              "24100000000",
              "24101000000",
              "24102000000",
              "24103000000",
              "24104000000",
              "24105000000",
              "24106000000",
              "24107000000",
              "24108000000",
              "24109000000",
              "24110000000",
              "24111000000",
              "24112000000",
              "24113000000",
              "24114000000",
              "24115000000",
              "24116000000",
              "24117000000",
              "24118000000",
              "24119000000",
              "24120000000",
              "24999000000",
              "25300000000",
              "25301000000",
              "25302000000",
              "25303000000",
              "25304000000",
              "25305000000",
              "25306000000",
              "25307000000",
              "25308000000",
              "25309000000",
              "25310000000",
              "25311000000",
              "25312000000",
              "25313000000",
              "25999000000",
              "26100000000",
              "26101000000",
              "26102000000",
              "26103000000",
              "26104000000",
              "26105000000",
              "26106000000",
              "26107000000",
              "26108000000",
              "26109000000",
              "26111000000",
              "26112000000",
              "26113000000",
              "26114000000",
              "26999000000",
              "27100000000",
              "27101000000",
              "27102000000",
              "27103000000",
              "27104000000",
              "27999000000",
              "28100000000",
              "28101000000",
              "29100000000",
              "29101000000",
              "29102000000",
              "29103000000",
              "29999000000",
              "30100000000",
              "30101000000",
              "30102000000"
            ],
            "type": "string",
            "description": "Narrow the ad search to one sub-industry (the title shows the top-level industry it belongs to). If you also set 'industry', the sub-industry must belong to it. Not used by trendingHashtags, which only takes the top-level industry."
          },
          "adPeriod": {
            "title": "Period (mode: topAds)",
            "enum": [
              "7",
              "30",
              "180"
            ],
            "type": "string",
            "description": "Time window of the ad ranking.",
            "default": "180"
          },
          "adSort": {
            "title": "Sort by (mode: topAds)",
            "enum": [
              "for_you",
              "likes"
            ],
            "type": "string",
            "description": "Order of the ads: the Creative Center's default ranking, or by likes.",
            "default": "for_you"
          },
          "objective": {
            "title": "Ad objective (mode: topAds)",
            "enum": [
              "1",
              "2",
              "3",
              "4",
              "5",
              "8",
              "15",
              "16"
            ],
            "type": "string",
            "description": "Only ads with this campaign objective. Leave empty for all."
          },
          "adLanguage": {
            "title": "Ad language (mode: topAds)",
            "enum": [
              "en",
              "es",
              "ar",
              "vi",
              "th",
              "de",
              "id",
              "pt",
              "fr",
              "ms",
              "nl",
              "ja",
              "it",
              "ro",
              "zh-Hant",
              "ko"
            ],
            "type": "string",
            "description": "Only ads in this language. Leave empty for all."
          },
          "adFormat": {
            "title": "Ad format (mode: topAds)",
            "enum": [
              "1",
              "2"
            ],
            "type": "string",
            "description": "Only Spark Ads (boosted organic posts) or only other ads. Leave empty for both."
          },
          "adPerformance": {
            "title": "Performance rank (mode: topAds)",
            "enum": [
              "1",
              "2",
              "3",
              "4",
              "5"
            ],
            "type": "string",
            "description": "Only ads in this fifth of the ranking by performance. Leave empty for all."
          },
          "includeKeyframe": {
            "title": "Include keyframe analysis (mode: adDetail)",
            "type": "boolean",
            "description": "Add one record per ad with the second-by-second retention curve. Charged as one more result.",
            "default": false
          },
          "includePercentile": {
            "title": "Include percentile (mode: adDetail)",
            "type": "boolean",
            "description": "Add one record per ad with its click-through rate percentile among all ads. Charged as one more result.",
            "default": false
          },
          "includeInteractive": {
            "title": "Include interactive analysis (mode: adDetail)",
            "type": "boolean",
            "description": "Add one record per ad with the viewer-interaction curve and its percentile. Charged as one more result.",
            "default": false
          },
          "hashtagPeriod": {
            "title": "Period in days (mode: trendingHashtags)",
            "enum": [
              "7",
              "30",
              "90"
            ],
            "type": "string",
            "description": "Time window of the hashtag ranking.",
            "default": "7"
          },
          "videoPeriod": {
            "title": "Period (mode: trendingVideos)",
            "enum": [
              "standard",
              "longer"
            ],
            "type": "string",
            "description": "Standard or longer ranking window of the trending videos.",
            "default": "standard"
          },
          "videoSort": {
            "title": "Rank by (mode: trendingVideos)",
            "enum": [
              "views",
              "engagement",
              "completion"
            ],
            "type": "string",
            "description": "Metric the trending videos are ranked by.",
            "default": "views"
          },
          "organicOnly": {
            "title": "Organic videos only (mode: trendingVideos)",
            "type": "boolean",
            "description": "Leave out videos that are ads.",
            "default": false
          },
          "includeDetails": {
            "title": "Include details (modes: trendingHashtags, trendingVideos)",
            "type": "boolean",
            "description": "Complete every record with its detail view: audience ages, countries and recent videos for a hashtag, comments and author region for a video. Slower; the records cost the same.",
            "default": false
          },
          "chart": {
            "title": "Chart (mode: musicChart)",
            "enum": [
              "top",
              "viral"
            ],
            "type": "string",
            "description": "Which music chart to read.",
            "default": "top"
          },
          "includeAudience": {
            "title": "Include audience (mode: searchInsights)",
            "type": "boolean",
            "description": "Add one record per topic with the age, gender and location of the people searching. Charged as one more result.",
            "default": false
          },
          "includeTrend": {
            "title": "Include trend (mode: searchInsights)",
            "type": "boolean",
            "description": "Add one record per topic with its weekly trend and top countries. Charged as one more result.",
            "default": false
          },
          "includeVideos": {
            "title": "Include videos (mode: searchInsights)",
            "type": "boolean",
            "description": "Add the top videos of each topic as records (up to 20 per topic). Each video is charged as one result.",
            "default": false
          },
          "maxResults": {
            "title": "Max results per keyword or ad",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Maximum records for each input (up to 1000; a mode without a list is one input). You are charged $0.0022 per record returned on the Bronze plan (less on higher plans), plus a $0.005 start fee per run. Keyword search pays the start fee again for every further keyword.",
            "default": 20
          }
        }
      },
      "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}