Douyin Scraper

What does Douyin Scraper do?

Douyin Scraper is a tool that enables you to scrape video data from the Douyin (Chinese TikTok). This is a ready-to-use scraping tool and doesn't require any programming knowledge to get started. Douyin Scraper allows you to:

✨ Features

• 🔎 Get posts from chosen hashtags or search terms.
• 📊 Get posts including details: name, ID, bio, followers/following numbers, etc.
• 🔗 Get individual video posts by using specific video URLs.
• 👤 Get posts from specific user profiles by using profile URLs.
• ⚙️ Configurable maximum number of posts and filters (e.g., publish time, more liked).
• 📥 Option to download videos and covers.

💡 Input parameters

If this actor is run on the Apify platform, our simple interface should help you out in configuring all the parameters. This scraper accept the following input fields:

• searchTermsOrHashtags - scrapes Douyin posts by search terms or hashtags. You can scrape one or several search terms or hashtags at the same time.
• searchSortFilter - sets the sort filter for search results. Options include general (default), most_liked, latest.
• searchPublishTimeFilter - sets the publish time filter for search results. Options include all (default), last_day, last_week or last_half_year.
• searchDurationFilter - sets the duration filter for search results. Options include all (default), within_one_minute, one_to_five_minutes, over_five_minutes.
• postUrls - scrapes specific Douyin posts. You can scrape one or several posts simultaneously. If you add a post URL, the Hashtags/terms will be ignored.
• profileUrls - scrapes Douyin posts from specific user profiles. If you add a Profile URL, the Hashtags/terms and Post URLs will be ignored.
• maxItemsPerUrl - sets up the amount of results you expect to be scraped per search term/hashtag or profile.
• profileSortFilter - sets the sort filter for profile posts. Options include latest (default), popular.
• shouldDownloadVideos - Choose whether or not download videos and replace the original play URL with a link to the video stored on the Key-Value Store.
• shouldDownloadCovers - Choose whether or not download covers and replace the original cover URL with a link to the cover stored on the Key-Value Store.

Example input 1 (scraping by search terms/hashtags):

{
  "searchTermsOrHashtags": ["#chinesetiktok", "anime edit"],
  "searchSortFilter": "most_liked",
  "maxItemsPerUrl": 500,
  "shouldDownloadVideos": false,
  "shouldDownloadCovers": false
}

Example input 2 (scraping by post URLs):

{
  "postUrls": ["https://www.douyin.com/video/7296149517517212980", "https://v.douyin.com/4fPfCoZb_U0"],
  "shouldDownloadVideos": false,
  "shouldDownloadCovers": false
}

Example input 3 (scraping by profile URLs):

{
  "profileUrls": ["https://www.douyin.com/user/MS4wLjABAAAAjb1juHnK9tygA0nuoGgSEMW7ZuJzXNnTMx9XwaQh19k"],
  "profileSortFilter": "popular",
  "maxItemsPerUrl": 200,
  "shouldDownloadVideos": false,
  "shouldDownloadCovers": false
}

📥 Example Output

{
  "id": "7296149517517212980",
  "text": "cute cats.:D#小咪会赶走你一天的疲惫 #喵星人",
  "createTime": 1698767202,
  "createDate": "25/10/2024",
  "thumb": "https://p9-pc-sign.douyinpic.com/tos-cn-i-0813c001/ogBDmIvOEfWACyQCMBznbAM9DsAeAASgASslI5~noop.jpeg?x-expires=1700596800&x-signature=k8o35CYFUDKhiiausDhDLKhRoIE%3D&from=3213915784&s=PackSourceEnum_SEARCH&se=false&biz_tag=pcweb_cover&l=20231108042539C059CD838A92B3375B32",
  "url": "https://www.douyin.com/video/7296149517517212980",
  "authorMeta": {
    "id": "101823080930",
    "secUid": "MS4wLjABAAAACvVkl3ZfT849YzNrTzxj3lDeWwxBFZFSYX7i_jLE8rw",
    "name": "Chandler",
    "username": "",
    "verified": false,
    "signature": ":-D",
    "avatarThumb": "https://p3-pc.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-i-0813c001_o4yF8yADNACtALzAAwtqmNIg2feBXdtAUNhEAE.jpeg?from=116350172",
    "avatarLarge": "https://p3-pc.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-i-0813c001_o4yF8yADNACtALzAAwtqmNIg2feBXdtAUNhEAE.jpeg?from=116350172",
    "followingCount": 0,
    "followersCount": 0,
    "heartCount": 0
  },
  "musicMeta": {
    "id": "7275161107433244674",
    "name": "麦当劳汉堡（正版授权版）",
    "author": "小pa",
    "album": "麦当劳汉堡（正版授权）",
    "isOriginal": false,
    "duration": 16
  },
  "videoMeta": {
    "cover": "https://p9-pc-sign.douyinpic.com/tos-cn-i-0813c001/ogBDmIvOEfWACyQCMBznbAM9DsAeAASgASslI5~noop.jpeg?x-expires=1700596800&x-signature=k8o35CYFUDKhiiausDhDLKhRoIE%3D&from=3213915784&s=PackSourceEnum_SEARCH&se=false&biz_tag=pcweb_cover&l=20231108042539C059CD838A92B3375B32",
    "originCover": "https://p3-pc-sign.douyinpic.com/tos-cn-i-0813c001/ogBDmIvOEfWACyQCMBznbAM9DsAeAASgASslI5~noop.jpeg?x-expires=1700596800&x-signature=g8b6UZkjdBMtb2qfpJpJtrNXnyg%3D&from=3213915784&s=PackSourceEnum_SEARCH&se=false&biz_tag=pcweb_cover&l=20231108042539C059CD838A92B3375B32",
    "width": 720,
    "playUrl": "https://sf9-sign.douyinstatic.com/tos-cn-ve-2774/os7Zzhg4IxkEARtNMB2VVQfDOerDkBt0DHCchq?x-expires=1699475139&x-signature=l%2FK1%2BGQt26k%2FJ0UYRp8yfIri4so%3D"
  },
  "statistics": {
    "diggCount": 1,
    "shareCount": 1,
    "commentCount": 1,
    "collectCount": 0
  },
  "mentions": [],
  "hashtags": [
    {
      "id": "1768145161646092",
      "name": "小咪会赶走你一天的疲惫"
    },
    {
      "id": "1560122388542465",
      "name": "喵星人"
    }
  ]
}

💲How much will scraping Douyin cost you?

The pricing changes according to your Apify plan.

• Free: $7.00/1,000 posts (Limited to 50 posts per profile or search term/hashtag to avoid abuse)
• Starter: $5.00/1,000 posts
• Scale: $4.00/1,000 posts
• Business: $4.00/1,000 posts

🧩 Integrations and Douyin Scraper

Douyin Scraper can be connected with almost any cloud service or web app thanks to integrations on the Apify platform. You can integrate with Make, Zapier, Slack, Airbyte, GitHub, Google Sheets, Google Drive, and more. Or you can use webhooks to carry out an action whenever an event occurs, e.g. get a notification whenever Douyin Scraper successfully finishes a run.

🔌Using Douyin Scraper with the Apify API

The Apify API gives you programmatic access to the Apify platform. The API is organized around RESTful HTTP endpoints that enable you to manage, schedule, and run Apify actors. The API also lets you access any datasets, monitor actor performance, fetch results, create and update versions, and more.

To access the API using Node.js, use the apify-client NPM package. To access the API using Python, use the apify-client PyPI package.

Check out the Apify API reference docs for full details or click on the API tab for code examples.

💬 Giving feedback

We’re always working on improving the performance of our Actors. So if you’ve got any technical feedback for Douyin scraper or simply found a bug, please create an issue on the Actor’s Issues tab in Apify Console.