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
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-listurl" ^
-d "spider_parameters=[{\"search_url\": \"https://www.tiktok.com/explore?lang=en\",\"country\": \"gb\",\"page_turning\": \"1\"}]" ^
-d "spider_errors=true" ^
-d "file_name={{TasksID}}"
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"
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-listurl" ^
-d "spider_parameters=[{\"search_url\": \"https://www.tiktok.com/explore?lang=en\",\"country\": \"gb\",\"page_turning\": \"1\"}]" ^
-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-listurl" ^
-d "spider_parameters=[{\"search_url\": \"https://www.tiktok.com/explore?lang=en\",\"country\": \"us\",\"page_turning\": \"1\"}]" ^
-d "spider_errors=true" ^
-d "file_name={{TasksID}}"page_turning ,Page Turning (optional)
This parameter specifies the limit on the number of crawled results.
Request examples:
"page_turning": "1"
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-listurl" ^
-d "spider_parameters=[{\"search_url\": \"https://www.tiktok.com/explore?lang=en\",\"country\": \"gb\",\"page_turning\": \"1\"}]" ^
-d "spider_errors=true" ^
-d "file_name={{TasksID}}"
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
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_posts_by-url" ^
-d "spider_parameters=[{\"url\": \"https://www.tiktok.com/@heymrcat/video/7216019547806092550\",\"country\": \"us\"}]" ^
-d "spider_errors=true" ^
-d "file_name={{TasksID}}"
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"
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_posts_by-url" ^
-d "spider_parameters=[{\"url\": \"https://www.tiktok.com/@heymrcat/video/7216019547806092550\",\"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_posts_by-url" ^
-d "spider_parameters=[{\"url\": \"https://www.tiktok.com/@heymrcat/video/7216019547806092550\",\"country\": \"us\"}]" ^
-d "spider_errors=true" ^
-d "file_name={{TasksID}}"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
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_posts_by-keywords" ^
-d "spider_parameters=[{\"search_keyword\": \"music\",\"num_of_posts\": \"10\",\"posts_to_not_include\": \"7481392272483896583\",\"country\": \"us\"}]" ^
-d "spider_errors=true" ^
-d "file_name={{TasksID}}"
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"
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_posts_by-keywords" ^
-d "spider_parameters=[{\"search_keyword\": \"music\",\"num_of_posts\": \"10\",\"posts_to_not_include\": \"7481392272483896583\",\"country\": \"us\"}]" ^
-d "spider_errors=true" ^
-d "file_name={{TasksID}}"
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"
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_posts_by-keywords" ^
-d "spider_parameters=[{\"search_keyword\": \"music\",\"num_of_posts\": \"10\",\"posts_to_not_include\": \"7481392272483896583\",\"country\": \"us\"}]" ^
-d "spider_errors=true" ^
-d "file_name={{TasksID}}"
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"
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_posts_by-keywords" ^
-d "spider_parameters=[{\"search_keyword\": \"music\",\"num_of_posts\": \"10\",\"posts_to_not_include\": \"7481392272483896583\",\"country\": \"us\"}]" ^
-d "spider_errors=true" ^
-d "file_name={{TasksID}}"
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
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_posts_by-profileurl" ^
-d "spider_parameters=[{\"url\": \"https://www.tiktok.com/@babyariel\",\"start_date\": \"08-05-2025\",\"end_date\": \"08-30-2025\",\"num_of_posts\": \"1\",\"what_to_collect\": \"Posts\",\"post_type\": \"Video Posts\",\"posts_to_not_include\": \"\",\"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/@babyariel"
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_posts_by-profileurl" ^
-d "spider_parameters=[{\"url\": \"https://www.tiktok.com/@babyariel\",\"start_date\": \"08-05-2025\",\"end_date\": \"08-30-2025\",\"num_of_posts\": \"1\",\"what_to_collect\": \"Posts\",\"post_type\": \"Video Posts\",\"posts_to_not_include\": \"\",\"country\": \"us\"}]" ^
-d "spider_errors=true" ^
-d "file_name={{TasksID}}"
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"
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_posts_by-profileurl" ^
-d "spider_parameters=[{\"url\": \"https://www.tiktok.com/@babyariel\",\"start_date\": \"08-05-2025\",\"end_date\": \"08-30-2025\",\"num_of_posts\": \"1\",\"what_to_collect\": \"Posts\",\"post_type\": \"Video Posts\",\"posts_to_not_include\": \"\",\"country\": \"us\"}]" ^
-d "spider_errors=true" ^
-d "file_name={{TasksID}}"
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"
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_posts_by-profileurl" ^
-d "spider_parameters=[{\"url\": \"https://www.tiktok.com/@babyariel\",\"start_date\": \"08-05-2025\",\"end_date\": \"08-30-2025\",\"num_of_posts\": \"1\",\"what_to_collect\": \"Posts\",\"post_type\": \"Video Posts\",\"posts_to_not_include\": \"\",\"country\": \"us\"}]" ^
-d "spider_errors=true" ^
-d "file_name={{TasksID}}"
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"
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_posts_by-profileurl" ^
-d "spider_parameters=[{\"url\": \"https://www.tiktok.com/@babyariel\",\"start_date\": \"08-05-2025\",\"end_date\": \"08-30-2025\",\"num_of_posts\": \"1\",\"what_to_collect\": \"Posts\",\"post_type\": \"Video Posts\",\"posts_to_not_include\": \"\",\"country\": \"us\"}]" ^
-d "spider_errors=true" ^
-d "file_name={{TasksID}}"
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"
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_posts_by-profileurl" ^
-d "spider_parameters=[{\"url\": \"https://www.tiktok.com/@babyariel\",\"start_date\": \"08-05-2025\",\"end_date\": \"08-30-2025\",\"num_of_posts\": \"1\",\"what_to_collect\": \"Posts\",\"post_type\": \"Video Posts\",\"posts_to_not_include\": \"\",\"country\": \"us\"}]" ^
-d "spider_errors=true" ^
-d "file_name={{TasksID}}"
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
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_posts_by-listurl" ^
-d "spider_parameters=[{\"url\": \"https://www.tiktok.com/discover/dog\",\"num_of_posts\": \"5\"}]" ^
-d "spider_errors=true" ^
-d "file_name={{TasksID}}"
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"
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_posts_by-listurl" ^
-d "spider_parameters=[{\"url\": \"https://www.tiktok.com/discover/dog\",\"num_of_posts\": \"5\"}]" ^
-d "spider_errors=true" ^
-d "file_name={{TasksID}}"
Product - Scrape comment information:
spider_id ,Scraper tool (required)
Defines which scraper tool to use.
Request examples:
spider_id=tiktok_comment_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_comment_by-url" ^
-d "spider_parameters=[{\"url\": \"https://www.tiktok.com/@heymrcat/video/7216019547806092550\",\"page_turning\": \"1\"}]" ^
-d "spider_errors=true" ^
-d "file_name={{TasksID}}"
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"
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_comment_by-url" ^
-d "spider_parameters=[{\"url\": \"https://www.tiktok.com/@heymrcat/video/7216019547806092550\",\"page_turning\": \"1\"}]" ^
-d "spider_errors=true" ^
-d "file_name={{TasksID}}"
page_turning ,Page Turning (optional)
This parameter specifies the limit on the number of crawled results.
Request examples:
"page_turning": "1"
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_comment_by-url" ^
-d "spider_parameters=[{\"url\": \"https://www.tiktok.com/@heymrcat/video/7216019547806092550\",\"page_turning\": \"1\"}]" ^
-d "spider_errors=true" ^
-d "file_name={{TasksID}}"
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
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_shop_by-url" ^
-d "spider_parameters=[{\"url\": \"https://www.tiktok.com/shop/pdp/long-sleeve-crew-neck-tee-3-pack-by-galaxy-by-harvic-cotton-blend/1729461570693075200\"}]" ^
-d "spider_errors=true" ^
-d "file_name={{TasksID}}"
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"
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_shop_by-url" ^
-d "spider_parameters=[{\"url\": \"https://www.tiktok.com/shop/pdp/long-sleeve-crew-neck-tee-3-pack-by-galaxy-by-harvic-cotton-blend/1729461570693075200\"}]" ^
-d "spider_errors=true" ^
-d "file_name={{TasksID}}"
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
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_shop_by-category-url" ^
-d "spider_parameters=[{\"category_url\": \"https://www.tiktok.com/shop/c/t-shirts/601226\"}]" ^
-d "spider_errors=true" ^
-d "file_name={{TasksID}}"
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"
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_shop_by-category-url" ^
-d "spider_parameters=[{\"category_url\": \"https://www.tiktok.com/shop/c/t-shirts/601226\"}]" ^
-d "spider_errors=true" ^
-d "file_name={{TasksID}}"
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
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_shop_by-keywords" ^
-d "spider_parameters=[{\"keyword\": \"T shirt\",\"domain\": \"https://www.tiktok.com/shop\",\"page_turning\": \"1\"}]" ^
-d "spider_errors=true" ^
-d "file_name={{TasksID}}"
keyword, Store Keywords (required)
This parameter is used to specify the keyword to search.
Request examples:
"keyword": "T shirt"
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_shop_by-keywords" ^
-d "spider_parameters=[{\"keyword\": \"T shirt\",\"domain\": \"https://www.tiktok.com/shop\",\"page_turning\": \"1\"}]" ^
-d "spider_errors=true" ^
-d "file_name={{TasksID}}"
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"
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_shop_by-keywords" ^
-d "spider_parameters=[{\"keyword\": \"T shirt\",\"domain\": \"https://www.tiktok.com/shop\",\"page_turning\": \"1\"}]" ^
-d "spider_errors=true" ^
-d "file_name={{TasksID}}"
page_turning ,Page Turning (optional)
This parameter specifies the limit on the number of crawled results.
Request examples:
"page_turning": "1"
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_shop_by-keywords" ^
-d "spider_parameters=[{\"keyword\": \"T shirt\",\"domain\": \"https://www.tiktok.com/shop\",\"page_turning\": \"1\"}]" ^
-d "spider_errors=true" ^
-d "file_name={{TasksID}}"
If you need further assistance, please contact us via email at [email protected].
Last updated
Was this helpful?