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:
token，Access token(required)
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
spider_id ，Scraper tool (required)
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}}"
url，Profile URL (required)
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}}"country，Country (optional)
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
spider_id ，Scraper tool (required)
Defines which scraper tool to use.
Request examples:
spider_id=tiktok_profiles_by-listurl
search_url ，Search URL (required)
This parameter specifies the search URL to be scraped.
Request examples:
"search_url": "https://www.tiktok.com/explore?lang=en"
country，Country (optional)
This parameter is used to specify the country to search.
Request examples:
"country": "us"
page_turning ，Page Turning (optional)
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
spider_id ，Scraper tool (required)
Defines which scraper tool to use.
Request examples:
spider_id=tiktok_posts_by-url
url ，Posts URL (required)
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"
country，Country (optional)
This parameter is used to specify the country to search.
Request examples:
"country": "us"
2.TikTok - Scrape post information by Keywords
spider_id ，Scraper tool (required)
Defines which scraper tool to use.
Request examples:
spider_id=tiktok_posts_by-keywords
search_keyword ，Search keyword (required)
This parameter is used to specify the posts to search by specific keywords or hashtags.
Request examples:
"search_keyword": "music"
num_of_posts ，Number of posts (optional)
This parameter is used to specify the number of posts to collect, missing values indicate no limit.
Request examples:
"num_of_posts": "10"
posts_to_not_include ，Posts not included (optional)
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
spider_id ，Scraper tool (required)
Defines which scraper tool to use.
Request examples:
spider_id=tiktok_posts_by-profileurl
url，Profile URL (required)
This parameter is used to specify the URL of the TikTok profile to scrape.
Request examples:
"url": "https://www.tiktok.com/@babyariel"
start_date，Start date (optional)
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"
end_date，End date (optional)
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"
what_to_collect，Content to be collected (optional)
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"
post_type，Post type (optional)
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
spider_id ，Scraper tool (required)
Defines which scraper tool to use.
Request examples:
spider_id=tiktok_posts_by-listurl
url ， List URL (optional)
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:
spider_id ，Scraper tool (required)
Defines which scraper tool to use.
Request examples:
spider_id=tiktok_comment_by-url
url ， Post URL (required)
This parameter is used to specify the post URL to be fetched.
Request examples:
"url": "https://www.tiktok.com/@heymrcat/video/7216019547806092550"
page_turning ，Page Turning (optional)
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
spider_id ，Scraper tool (required)
Defines which scraper tool to use.
Request examples:
spider_id=tiktok_shop_by-url
url ， Shop URL (required)
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
spider_id ，Scraper tool (required)
Defines which scraper tool to use.
Request examples:
spider_id=tiktok_shop_by-category-url
category_url ， Category URL (required)
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
spider_id ，Scraper tool (required)
Defines which scraper tool to use.
Request examples:
spider_id=tiktok_shop_by-keywords
keyword， Store Keywords (required)
This parameter is used to specify the keyword to search.
Request examples:
"keyword": "T shirt"
domain，Domain (optional）
This parameter is used to specify the domain of the TikTok shop to be crawled.
Request examples:
"domain": "https://www.tiktok.com/shop"
page_turning ，Page Turning (optional)
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?