{
  "openapi": "3.0.1",
  "info": {
    "title": "TikTok Trending Hashtags Scraper",
    "description": "Get TikTok Creative Center trending hashtags for 60+ countries. Pull the full ranked Top 100 for a country and industry, or merge every industry list into about 50-55 tags. Every row has posts, views, a daily sparkline, a rising/peaking/fading stage and top creators.",
    "version": "1.5",
    "x-build-id": "qbXlmhQktqczxWcuR"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/khadinakbar~tiktok-trending-hashtags-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-khadinakbar-tiktok-trending-hashtags-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/khadinakbar~tiktok-trending-hashtags-scraper/runs": {
      "post": {
        "operationId": "runs-sync-khadinakbar-tiktok-trending-hashtags-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/khadinakbar~tiktok-trending-hashtags-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-khadinakbar-tiktok-trending-hashtags-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": {
          "timePeriod": {
            "title": "Time Period",
            "enum": [
              "7",
              "30",
              "90"
            ],
            "type": "string",
            "description": "Trending window supported by TikTok One Trends. Use 7 days for the latest trends, 30 days for monthly trends, or 90 days for a longer view.",
            "default": "7"
          },
          "country": {
            "title": "Country",
            "enum": [
              "US",
              "GB",
              "IN",
              "BR",
              "MX",
              "ID",
              "JP",
              "KR",
              "DE",
              "FR",
              "TR",
              "RU",
              "ES",
              "IT",
              "CA",
              "AU",
              "AR",
              "CO",
              "TH",
              "VN",
              "NL",
              "PL",
              "SA",
              "AE",
              "SG",
              "PH",
              "MY",
              "NG",
              "ZA",
              "CL",
              "PE",
              "TW",
              "PK",
              "BD",
              "EG",
              "AT",
              "BE",
              "BG",
              "BY",
              "CZ",
              "DK",
              "FI",
              "GR",
              "HU",
              "IE",
              "IL",
              "IQ",
              "IS",
              "KH",
              "KW",
              "LB",
              "LT",
              "LV",
              "MA",
              "MM",
              "NO",
              "NZ",
              "OM",
              "PT",
              "QA",
              "RO",
              "SK",
              "SE",
              "CH",
              "UA",
              "UZ"
            ],
            "type": "string",
            "description": "Filter trending hashtags by country. Choose the country where you want to research trends. The default is the United States.",
            "default": "US"
          },
          "countries": {
            "title": "Countries (optional, several markets)",
            "type": "array",
            "description": "Use this to compare several markets in one run. Enter up to 10 two-letter country codes such as US, GB and DE. When set, it replaces Country, and Max Hashtags applies to each country. Leave empty to use the single Country field.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "industry": {
            "title": "Industry / Niche",
            "enum": [
              "All Industries",
              "Gaming",
              "Beauty & Personal Care",
              "Food & Beverage",
              "Health & Fitness",
              "Entertainment",
              "Sports & Outdoors",
              "Education",
              "Travel",
              "Fashion & Apparel",
              "Technology",
              "Home & Décor",
              "Parenting & Kids",
              "Media & Entertainment",
              "News & Information",
              "Vehicles & Transportation",
              "Financial Services",
              "Household Appliances",
              "Household Products",
              "Pets",
              "Apps",
              "Business Services",
              "Life Services"
            ],
            "type": "string",
            "description": "Filter by industry vertical. Use this when the user mentions a niche like 'beauty', 'gaming', 'fashion', or 'fitness'. Leave as 'All Industries' for the overall list. Entertainment, Media & Entertainment and News & Information are the same TikTok list. To combine every industry list, turn on Combine all industry lists instead of picking one.",
            "default": "All Industries"
          },
          "maxResults": {
            "title": "Max Hashtags",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Maximum number of trending hashtags to return per country (1–100). TikTok publishes only about 3 public hashtags per list, so one industry returns about 3 rows. Turn on Combine all industry lists to get about 40–55 per country. You are charged only for records written to the dataset.",
            "default": 100
          },
          "allIndustryLists": {
            "title": "Combine all industry lists",
            "type": "boolean",
            "description": "When true, reads the overall list plus every industry list TikTok publishes for each country and merges them without duplicates. This returns about 40–55 hashtags per country instead of about 3. Each row shows the list where the hashtag ranks best in industry_name and TikTok's own industry tags in hashtag_industries. Leave Industry on 'All Industries' when you use this.",
            "default": false
          },
          "fullRankings": {
            "title": "Full rankings (up to 100 per list)",
            "type": "boolean",
            "description": "When true, returns the full ranked list of up to 100 hashtags for the chosen country, industry and time period, instead of the 3 hashtags TikTok shows publicly. Use Max Hashtags to choose how many. Cannot be combined with Combine all industry lists. If it is unavailable, the run stops before charging anything and tells you so.",
            "default": false
          },
          "risingOnly": {
            "title": "Rising hashtags only",
            "type": "boolean",
            "description": "When true, keeps only hashtags whose trend_stage is 'rising' (popularity climbing at the end of the window). Applied before Max Hashtags.",
            "default": false
          },
          "minPosts": {
            "title": "Minimum posts",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only hashtags with at least this many posts (post_count). 0 turns the filter off. Hashtags with no post count are dropped when this is above 0.",
            "default": 0
          },
          "minViews": {
            "title": "Minimum video views",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only hashtags with at least this many total video views (video_views). 0 turns the filter off. Hashtags with no view count are dropped when this is above 0.",
            "default": 0
          },
          "onlyNewSinceLastRun": {
            "title": "Only hashtags new since the last run",
            "type": "boolean",
            "description": "When true, returns only hashtags that were not in the list at your previous run with the same country, time period and industry setting, and charges only for those. The first run returns everything and saves a baseline. Memory is kept in a key-value store named 'trending-hashtags-seen' in your own Apify account. Use it with a schedule to watch for new trends.",
            "default": false
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}