TikTok Scraping Parameters

Web Scraper API TikTok Scraping Parameters

Configure TikTok Scraping Parameters using Thordata's Web Scraper API, including Profile URL, Posts URL, Search URL, Page Turning, Shop URL, Keywords and other parameters.

Unique Identifier:

chevron-righttokenAccess token(required)hashtag

This parameter is used as the API access token to ensure the legitimacy of the scraping request.

Request examples:

Authorization: Bearer ********************

curl -X POST "https://scraperapi.thordata.com/builder" ^
  -H "Authorization: Bearer ********************" ^
  -H "Content-Type: application/x-www-form-urlencoded" ^
  -d "spider_name=tiktok.com" ^
  -d "spider_id=tiktok_profiles_by-url" ^
  -d "spider_parameters=[{\"url\": \"https://www.tiktok.com/@fofimdmell\",\"country\": \"us\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"

Product - Scrape profile information:

1. TikTok - Scrape profile information by URL

chevron-rightspider_idScraper tool (required)hashtag

Defines which scraper tool to use.

Request examples:

spider_id=tiktok_profiles_by-url

curl -X POST "https://scraperapi.thordata.com/builder" ^
  -H "Authorization: Bearer Token-ID" ^
  -H "Content-Type: application/x-www-form-urlencoded" ^
  -d "spider_name=tiktok.com" ^
  -d "spider_id=tiktok_profiles_by-url" ^
  -d "spider_parameters=[{\"url\": \"https://www.tiktok.com/@fofimdmell\",\"country\": \"us\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
chevron-righturlProfile URL (required)hashtag

This parameter is used to specify the URL of the TikTok profile to scrape.

Request examples:

"url": "https://www.tiktok.com/@fofimdmell"

curl -X POST "https://scraperapi.thordata.com/builder" ^
  -H "Authorization: Bearer Token-ID" ^
  -H "Content-Type: application/x-www-form-urlencoded" ^
  -d "spider_name=tiktok.com" ^
  -d "spider_id=tiktok_profiles_by-url" ^
  -d "spider_parameters=[{\"url\": \"https://www.tiktok.com/@fofimdmell\",\"country\": \"us\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
chevron-rightcountryCountry (optional)hashtag

This parameter is used to specify the country to search.

Request examples:

"country": "us"

curl -X POST "https://scraperapi.thordata.com/builder" ^
  -H "Authorization: Bearer Token-ID" ^
  -H "Content-Type: application/x-www-form-urlencoded" ^
  -d "spider_name=tiktok.com" ^
  -d "spider_id=tiktok_profiles_by-url" ^
  -d "spider_parameters=[{\"url\": \"https://www.tiktok.com/@fofimdmell\",\"country\": \"us\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"

2.TikTok - Scrape profile information by Search URL

chevron-rightspider_idScraper tool (required)hashtag

Defines which scraper tool to use.

Request examples:

spider_id=tiktok_profiles_by-listurl

chevron-rightsearch_urlSearch URL (required)hashtag

This parameter specifies the search URL to be scraped.

Request examples:

"search_url": "https://www.tiktok.com/explore?lang=en"

chevron-rightcountryCountry (optional)hashtag

This parameter is used to specify the country to search.

Request examples:

"country": "us"

chevron-rightpage_turningPage Turning (optional)hashtag

This parameter specifies the limit on the number of crawled results.

Request examples:

"page_turning": "1"

Product - Scrape post information:

1.TikTok - Scrape post information by URL

chevron-rightspider_idScraper tool (required)hashtag

Defines which scraper tool to use.

Request examples:

spider_id=tiktok_posts_by-url

chevron-righturlPosts URL (required)hashtag

This parameter is used to specify the URL of the specific TikTok post to scrape.

Request examples:

"url": "https://www.tiktok.com/@heymrcat/video/7216019547806092550"

chevron-rightcountryCountry (optional)hashtag

This parameter is used to specify the country to search.

Request examples:

"country": "us"

2.TikTok - Scrape post information by Keywords

chevron-rightspider_idScraper tool (required)hashtag

Defines which scraper tool to use.

Request examples:

spider_id=tiktok_posts_by-keywords

chevron-rightsearch_keywordSearch keyword (required)hashtag

This parameter is used to specify the posts to search by specific keywords or hashtags.

Request examples:

"search_keyword": "music"

chevron-rightnum_of_postsNumber of posts (optional)hashtag

This parameter is used to specify the number of posts to collect, missing values indicate no limit.

Request examples:

"num_of_posts": "10"

chevron-rightposts_to_not_includePosts not included (optional)hashtag

This parameter is used to specify the posts to be excluded from the crawling results; please enter the post ID.

Request examples:

"posts_to_not_include": "7481392272483896583"

3.TikTok - Scrape post information by Profile URL

chevron-rightspider_idScraper tool (required)hashtag

Defines which scraper tool to use.

Request examples:

spider_id=tiktok_posts_by-profileurl

chevron-righturlProfile URL (required)hashtag

This parameter is used to specify the URL of the TikTok profile to scrape.

Request examples:

"url": "https://www.tiktok.com/@babyariel"

chevron-rightstart_dateStart date (optional)hashtag

This parameter is used to specify the start time of the post, format: mm-dd-yyyy, and should be earlier than the "end_date".

Request examples:

"start_date": "08-05-2025"

chevron-rightend_dateEnd date (optional)hashtag

This parameter is used to specify the end time of the post, format: mm-dd-yyyy, and should be later than the "start_date".

Request examples:

"end_date": "08-30-2025"

chevron-rightwhat_to_collectContent to be collected (optional)hashtag

This parameter is used to specify the content type to be collected: posts, re-shares, both, or liked posts.

Request examples:

"what_to_collect": "Posts"

chevron-rightpost_typePost type (optional)hashtag

This parameter is used to specify the type of posts to collect: Video Posts or Image Posts.

Request examples:

"post_type": "Video Posts"

4.TikTok - Scrape post information by List URL

chevron-rightspider_idScraper tool (required)hashtag

Defines which scraper tool to use.

Request examples:

spider_id=tiktok_posts_by-listurl

chevron-righturlList URL (optional)hashtag

This parameter is used to specify the list URL to be fetched.

Request examples:

"url": "https://www.tiktok.com/discover/dog"

Product - Scrape comment information:

chevron-rightspider_idScraper tool (required)hashtag

Defines which scraper tool to use.

Request examples:

spider_id=tiktok_comment_by-url

chevron-righturl Post URL (required)hashtag

This parameter is used to specify the post URL to be fetched.

Request examples:

"url": "https://www.tiktok.com/@heymrcat/video/7216019547806092550"

chevron-rightpage_turningPage Turning (optional)hashtag

This parameter specifies the limit on the number of crawled results.

Request examples:

"page_turning": "1"

Product - Scrape TikTok shop information:

1.TikTok - Scrape TikTok shop information by URL

chevron-rightspider_idScraper tool (required)hashtag

Defines which scraper tool to use.

Request examples:

spider_id=tiktok_shop_by-url

chevron-righturlShop URL (required)hashtag

This parameter is used to specify the shop URL to be fetched.

Request examples:

"url": "https://www.tiktok.com/shop/pdp/long-sleeve-crew-neck-tee-3-pack-by-galaxy-by-harvic-cotton-blend/1729461570693075200"

2.TikTok - Scrape TikTok shop information by category URL

chevron-rightspider_idScraper tool (required)hashtag

Defines which scraper tool to use.

Request examples:

spider_id=tiktok_shop_by-category-url

chevron-rightcategory_url Category URL (required)hashtag

This parameter is used to specify the category URL to be fetched.

Request examples:

"category_url": "https://www.tiktok.com/shop/c/t-shirts/601226"

3.TikTok - Scrape TikTok shop information by keywords

chevron-rightspider_idScraper tool (required)hashtag

Defines which scraper tool to use.

Request examples:

spider_id=tiktok_shop_by-keywords

chevron-rightkeyword Store Keywords (required)hashtag

This parameter is used to specify the keyword to search.

Request examples:

"keyword": "T shirt"

chevron-rightdomainDomain (optional)hashtag

This parameter is used to specify the domain of the TikTok shop to be crawled.

Request examples:

"domain": "https://www.tiktok.com/shop"

chevron-rightpage_turningPage Turning (optional)hashtag

This parameter specifies the limit on the number of crawled results.

Request examples:

"page_turning": "1"

If you need further assistance, please contact us via email at [email protected].

Last updated

Was this helpful?