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:

• 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 video and music-related data.

How much will scraping Douyin cost you?

When it comes to scraping, it can be challenging to estimate the resources needed to extract data as use cases may vary significantly. That's why the best course of action is to run a test scrape with a small sample of input data and limited output. You’ll get your price per scrape, which you’ll then multiply by the number of scrapes you intend to do.

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.
• postUrls - scrapes specific Douyin posts. You can scrape one or several posts simultaneously.
• maxItemsPerUrl - sets up the amount of results you expect to be scraped for each URL.
• 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.

Please note that only one of the following must be set: searchTermsOrHashtags, or postUrls, not both at the same time.

Example Output

1{
2  "id": "7296149517517212980",
3  "text": "cute cats.:D#小咪会赶走你一天的疲惫 #喵星人",
4  "createTime": 1698767202,
5  "createDate": "2023-08-11",
6  "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",
7  "url": "https://www.douyin.com/video/7296149517517212980",
8  "authorMeta": {
9    "id": "101823080930",
10    "secUid": "MS4wLjABAAAACvVkl3ZfT849YzNrTzxj3lDeWwxBFZFSYX7i_jLE8rw",
11    "name": "Chandler",
12    "username": "",
13    "verified": false,
14    "signature": ":-D",
15    "avatarThumb": "https://p3-pc.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-i-0813c001_o4yF8yADNACtALzAAwtqmNIg2feBXdtAUNhEAE.jpeg?from=116350172",
16    "avatarLarge": "https://p3-pc.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-i-0813c001_o4yF8yADNACtALzAAwtqmNIg2feBXdtAUNhEAE.jpeg?from=116350172",
17    "followingCount": 0,
18    "followersCount": 0,
19    "heartCount": 0
20  },
21  "musicMeta": {
22    "id": "7275161107433244674",
23    "name": "麦当劳汉堡（正版授权版）",
24    "author": "小pa",
25    "album": "麦当劳汉堡（正版授权）",
26    "isOriginal": false,
27    "duration": 16
28  },
29  "videoMeta": {
30    "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",
31    "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",
32    "width": 720,
33    "playUrl": "https://sf9-sign.douyinstatic.com/tos-cn-ve-2774/os7Zzhg4IxkEARtNMB2VVQfDOerDkBt0DHCchq?x-expires=1699475139&x-signature=l%2FK1%2BGQt26k%2FJ0UYRp8yfIri4so%3D"
34  },
35  "statistics": {
36    "diggCount": 1,
37    "shareCount": 1,
38    "commentCount": 1,
39    "collectCount": 0
40  },
41  "mentions": [],
42  "hashtags": [
43    {
44      "id": "1768145161646092",
45      "name": "小咪会赶走你一天的疲惫"
46    },
47    {
48      "id": "1560122388542465",
49      "name": "喵星人"
50    }
51  ]
52}

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.

Personal data

You should be aware that your results might contain personal data. Personal data is protected by GDPR in the European Union and other laws and regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. You can read the basics of ethical web scraping in our blog post on the legality of web scraping.

Your 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.