{
  "openapi": "3.0.1",
  "info": {
    "title": "TikTok Scraper: Profiles, Videos & Transcripts",
    "description": "Scrape TikTok profiles, videos, photo posts and transcripts without login: followers, views, likes, comments, shares, engagement rate, hashtags, sounds and the spoken text with timestamps. Free date and view filters, only-new-video monitoring. For influencer research, social listening and AI.",
    "version": "1.0",
    "x-build-id": "32ixaXLAFsyca4Elz"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/panix~tiktok-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-panix-tiktok-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/panix~tiktok-scraper/runs": {
      "post": {
        "operationId": "runs-sync-panix-tiktok-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/panix~tiktok-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-panix-tiktok-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": {
          "profiles": {
            "title": "Profiles",
            "type": "array",
            "description": "TikTok usernames (natgeo or @natgeo) or profile links (https://www.tiktok.com/@natgeo). You get one profile row with followers, likes, bio and recent engagement, plus the profile's newest videos.",
            "items": {
              "type": "string"
            }
          },
          "videoUrls": {
            "title": "Video and photo links",
            "type": "array",
            "description": "Links to single TikTok videos or photo posts (https://www.tiktok.com/@user/video/123...), share links (vm.tiktok.com/..., tiktok.com/t/...) or bare video IDs.",
            "items": {
              "type": "string"
            }
          },
          "resultsPerProfile": {
            "title": "Videos per profile",
            "minimum": 0,
            "maximum": 10000,
            "type": "integer",
            "description": "How many of each profile's newest videos and photo posts to deliver. 0 = profile rows only.",
            "default": 10
          },
          "includeTranscripts": {
            "title": "Include transcripts",
            "type": "boolean",
            "description": "Add the spoken text of each video from TikTok's captions (auto-generated speech captions or the creator's own). Videos without captions are delivered at the plain video price, with transcriptStatus = no_captions.",
            "default": true
          },
          "transcriptLanguage": {
            "title": "Preferred transcript language",
            "type": "string",
            "description": "Language code such as en, es, de, pt or eng-US. Used when a video offers captions in several languages. Empty = the video's original spoken language.",
            "default": ""
          },
          "transcriptTimestamps": {
            "title": "Timestamped transcript segments",
            "type": "boolean",
            "description": "Also add transcriptSegments: a list of {start, end, text} in seconds, for subtitles, clipping or search.",
            "default": false
          },
          "newerThan": {
            "title": "Only videos newer than",
            "type": "string",
            "description": "Profile videos posted on or after this date. A date (2026-10-01) or a period back from now (7 days, 2 weeks, 3 months). The list stops at the first older video, so you don't pay for reading past it."
          },
          "olderThan": {
            "title": "Only videos older than",
            "type": "string",
            "description": "Profile videos posted before this date (2026-10-31) or period (30 days)."
          },
          "minViews": {
            "title": "Minimum views",
            "minimum": 0,
            "type": "integer",
            "description": "Leave out profile videos with fewer views."
          },
          "minLikes": {
            "title": "Minimum likes",
            "minimum": 0,
            "type": "integer",
            "description": "Leave out profile videos with fewer likes."
          },
          "postType": {
            "title": "Post type",
            "enum": [
              "all",
              "video",
              "photo"
            ],
            "type": "string",
            "description": "Deliver all posts, only videos, or only photo posts (slideshows).",
            "default": "all"
          },
          "onlyNewVideos": {
            "title": "Only new videos since the last run",
            "type": "boolean",
            "description": "For scheduled runs: remember what each profile posted and deliver (and charge) only videos posted since the previous run with the same memory name. The first run delivers the newest videos as usual. Profile rows are always delivered.",
            "default": false
          },
          "monitorName": {
            "title": "Memory name",
            "type": "string",
            "description": "Name of the memory for 'Only new videos'. Use a different name per schedule or client (letters, digits, - and _).",
            "default": "default"
          },
          "profileStats": {
            "title": "Recent engagement on profile rows",
            "type": "boolean",
            "description": "Add average and median views, likes, comments, shares, engagement rate and posts per week over the profile's 15 newest posts. Free.",
            "default": true
          },
          "maxResults": {
            "title": "Maximum videos in total",
            "minimum": 1,
            "type": "integer",
            "description": "Stop after this many videos across all inputs. Empty = no limit (the run's spending limit still applies)."
          },
          "maxConcurrency": {
            "title": "Parallel requests",
            "minimum": 1,
            "maximum": 30,
            "type": "integer",
            "description": "How many TikTok requests run at the same time.",
            "default": 10
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Apify's datacenter proxy works for TikTok and is the cheapest. Change only if you have a reason.",
            "default": {
              "useApifyProxy": 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}