TikTok Profile Videos Scraper

An Apify actor that extracts structured video data from TikTok profiles. It fetches all available videos for given usernames and returns detailed metadata, stats, and media URLs. The actor can run on the Apify platform or locally, saving results to a dataset or a local JSON file.

Key Features

• Fetches all available videos from one or multiple TikTok profiles.
• Returns comprehensive video metadata: ID, timestamp, description, duration, and thumbnail/cover URLs.
• Provides video statistics: views, likes, comments, and shares (when available).
• Preserves the raw API response and adds minimal metadata (_requested_profile, _http_status).
• Works as an Apify actor (pushes items to the dataset) or locally (writes to result.json).
• Accepts flexible input formats (JSON, environment variable, or Apify platform input).

How to Use

Provide the target TikTok username(s) via the actor's input. The actor accepts several input formats.

Input Format

You can specify a single profile or a list of usernames.

Single Profile:

{
  "profile": "omoralwaysonfire07"
}

Multiple Profiles:

{
  "usernames": [
    "omoralwaysonfire07",
    "hamzakhanshayan",
    "khaby.lame"
  ]
}

You can also provide a comma-separated or newline-separated string of usernames via a usernames field.

Output

The actor outputs an array of objects. Each object contains a status and a data field. The data field holds the full API response, which includes an array of videos with complete details for each video.

A condensed example of the output structure is below. The actual response includes many more fields for each video.

[
  {
    "status": "success",
    "data": {
      "code": 0,
      "msg": "success",
      "processed_time": 0.4603,
      "data": {
        "videos": [
          {
            "aweme_id": "v14044g50000d3l4hsnog65jc6mqn0b0",
            "title": "প্রাসাদ বানানো আমার শখ না এটা বাধ্যতামূলক#omoralwaysonfire ",
            "duration": 25,
            "play": "https://v45.tiktokcdn-eu.com/...video.mp4",
            "wmplay": "https://v45.tiktokcdn-eu.com/...video.mp4",
            "music": "https://sf16-ies-music-sg.tiktokcdn.com/...music.mp3"
          }
        ]
      }
    }
  }
]

When run on the Apify platform, each video item is pushed individually to the default dataset. When run locally, the combined results are written to result.json.