{
  "openapi": "3.0.1",
  "info": {
    "title": "TikTok Creative Center Scraper: Top Ads, Hashtags, Videos",
    "description": "Scrape TikTok Creative Center top ads by country, industry and objective: landing page, likes, comments, shares, CTR, budget level, target countries and video link, plus trending hashtags and top videos. No login.",
    "version": "0.1",
    "x-build-id": "2OPOXDV0E5wkXWZ0S"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/themineworks~tiktok-creative-center-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-themineworks-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/themineworks~tiktok-creative-center-scraper/runs": {
      "post": {
        "operationId": "runs-sync-themineworks-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/themineworks~tiktok-creative-center-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-themineworks-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",
        "properties": {
          "dataTypes": {
            "title": "What to read",
            "type": "array",
            "description": "Top ads: the auction ads TikTok shows in its Creative Center, 28 countries or all at once. Trending hashtags: 27 countries. Top videos: US, Japan, Vietnam, Thailand and Indonesia. Pick one or more.",
            "items": {
              "type": "string",
              "enum": [
                "topAds",
                "hashtags",
                "videos"
              ],
              "enumTitles": [
                "Top ads",
                "Trending hashtags",
                "Top videos"
              ]
            },
            "default": [
              "topAds"
            ]
          },
          "countries": {
            "title": "Countries",
            "type": "array",
            "description": "Each country is read on its own. ALL reads top ads of every country at once (top ads only). A country that has no chart for a data type gets an error row and costs nothing.",
            "items": {
              "type": "string",
              "enum": [
                "ALL",
                "US",
                "GB",
                "CA",
                "AU",
                "DE",
                "FR",
                "IT",
                "ES",
                "NL",
                "SE",
                "RO",
                "TR",
                "AR",
                "BR",
                "CO",
                "MX",
                "SA",
                "AE",
                "EG",
                "IL",
                "ZA",
                "PK",
                "ID",
                "JP",
                "KR",
                "MY",
                "PH",
                "SG",
                "TW",
                "TH",
                "VN"
              ],
              "enumTitles": [
                "All countries (top ads only)",
                "United States",
                "United Kingdom",
                "Canada",
                "Australia",
                "Germany",
                "France",
                "Italy",
                "Spain",
                "Netherlands (top ads only)",
                "Sweden (top ads only)",
                "Romania (top ads only)",
                "Turkey",
                "Argentina",
                "Brazil",
                "Colombia",
                "Mexico",
                "Saudi Arabia",
                "United Arab Emirates",
                "Egypt (hashtags only)",
                "Israel (hashtags only)",
                "South Africa",
                "Pakistan (top ads only)",
                "Indonesia",
                "Japan",
                "South Korea",
                "Malaysia",
                "Philippines",
                "Singapore",
                "Taiwan (hashtags only)",
                "Thailand",
                "Vietnam"
              ]
            },
            "default": [
              "US"
            ]
          },
          "period": {
            "title": "Time window",
            "enum": [
              "7",
              "30",
              "180"
            ],
            "type": "string",
            "description": "Last 7, 30 or 180 days. Hashtag charts go back 90 days at most and top video charts 30 days, so 180 reads those for 90 and 30 days.",
            "default": "30"
          },
          "maxItems": {
            "title": "Max rows",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Most rows for the whole run, across countries and data types. Top ads per country are capped by what TikTok holds for your filters (125 for the US over 30 days in our test).",
            "default": 100
          },
          "includeDetails": {
            "title": "Ad details (landing page, comments, shares, countries, keywords)",
            "type": "boolean",
            "description": "Opens each ad's detail record: landing page and its domain, comments, shares, the countries the ad ran in, TikTok's keywords for it, every campaign objective, creative patterns and voice over. Same price either way.",
            "default": true
          },
          "includeAnalytics": {
            "title": "Ad analytics (second by second curves and percentiles)",
            "type": "boolean",
            "description": "Adds, per ad: viewer retention, CTR and clicks for each second of the video, the highlight seconds TikTok marks, and where the ad ranks against its industry on CTR, clicks and reach. Charged as a separate ad-analytics event per ad.",
            "default": false
          },
          "sortBy": {
            "title": "Rankings to read",
            "type": "array",
            "description": "Leave empty to read all seven and merge them. TikTok shows visitors who are not logged in the top 20 ads of each ranking, so more rankings means more different ads.",
            "items": {
              "type": "string",
              "enum": [
                "for_you",
                "reach",
                "ctr",
                "cvr",
                "two_second_view_rate",
                "six_second_view_rate",
                "likes"
              ],
              "enumTitles": [
                "For you",
                "Reach",
                "CTR",
                "CVR",
                "2 second view rate",
                "6 second view rate",
                "Likes"
              ]
            },
            "default": []
          },
          "industries": {
            "title": "Industries",
            "type": "array",
            "description": "Leave empty for all industries. Pick some to read only ads of those industries (each industry is read on its own, up to 20 ads per ranking).",
            "items": {
              "type": "string",
              "enum": [
                "apparel-accessories",
                "appliances",
                "apps",
                "baby-kids-maternity",
                "beauty-personal-care",
                "business-services",
                "e-commerce",
                "education",
                "financial-services",
                "food-beverage",
                "games",
                "health",
                "home-improvement",
                "household-products",
                "life-services",
                "news-entertainment",
                "pets",
                "sports-outdoor",
                "tech-electronics",
                "travel",
                "vehicle-transportation"
              ],
              "enumTitles": [
                "Apparel & Accessories",
                "Appliances",
                "Apps",
                "Baby, Kids & Maternity",
                "Beauty & Personal Care",
                "Business Services",
                "E-Commerce (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"
              ]
            },
            "default": []
          },
          "expandByIndustry": {
            "title": "Reach deeper through industry rankings",
            "type": "boolean",
            "description": "With no industry picked, when the overall rankings give fewer different ads than you asked for, the actor also reads each industry's rankings (114 of the 125 US ads over 30 days in our test, against 41 from the overall rankings). Turn off for the overall rankings only.",
            "default": true
          },
          "objectives": {
            "title": "Campaign objectives",
            "type": "array",
            "description": "Leave empty for all. Only ads run for these objectives.",
            "items": {
              "type": "string",
              "enum": [
                "traffic",
                "app-installs",
                "conversions",
                "video-views",
                "reach",
                "lead-generation",
                "product-sales",
                "app-promotion"
              ],
              "enumTitles": [
                "Traffic",
                "App installs",
                "Conversions",
                "Video views",
                "Reach",
                "Lead generation",
                "Product sales",
                "App promotion"
              ]
            },
            "default": []
          },
          "adLanguages": {
            "title": "Ad languages",
            "type": "array",
            "description": "Leave empty for all. Only ads in these languages.",
            "items": {
              "type": "string",
              "enum": [
                "en",
                "es",
                "pt",
                "fr",
                "de",
                "it",
                "nl",
                "ro",
                "ar",
                "id",
                "ms",
                "th",
                "vi",
                "ja",
                "ko",
                "zh-Hant"
              ],
              "enumTitles": [
                "English",
                "Spanish",
                "Portuguese",
                "French",
                "German",
                "Italian",
                "Dutch",
                "Romanian",
                "Arabic",
                "Indonesian",
                "Malay",
                "Thai",
                "Vietnamese",
                "Japanese",
                "Korean",
                "Chinese (Traditional)"
              ]
            },
            "default": []
          },
          "adFormat": {
            "title": "Ad format",
            "enum": [
              "all",
              "spark",
              "non-spark"
            ],
            "type": "string",
            "description": "Spark ads (boosted organic posts) or other ads, or both.",
            "default": "all"
          },
          "likesTier": {
            "title": "Likes tier",
            "enum": [
              "all",
              "top-1-20",
              "top-21-40",
              "top-41-60",
              "top-61-80",
              "top-81-100"
            ],
            "type": "string",
            "description": "Only ads whose likes rank in this band of the top ads, or all.",
            "default": "all"
          },
          "includeTopCreators": {
            "title": "Top creators of each hashtag",
            "type": "boolean",
            "description": "For trending hashtags: adds the creators TikTok lists for each hashtag (username, nickname, followers, country, profile link). Same price either way.",
            "default": true
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}