For the complete documentation index, see llms.txt. This page is also available as Markdown.

Instagram Scraping Parameters

Web Scraper API Instagram Scraping Parameters

Use Thordata's Web Scraper API to configure Instagram scraping parameters, including profile URL, maximum number of posts, start date, end date, post type, post URL, username, number of comments to scrape, whether to scrape latest comments, whether to scrape replies, maximum number of Reels to scrape, and more.

Unique Identifier:

token ,Access token (required)

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

Request Example:

Bearer ********************************

curl -X POST "https://scraperapi.thordata.com/builder" ^
  -H "Authorization: Bearer ********************************" ^
  -H "Content-Type: application/x-www-form-urlencoded" ^
  -d "spider_name=instagram.com" ^
  -d "spider_id=ins_posts_by-profileurl" ^
  -d "spider_parameters=[{\"profileurl\": \"https://www.instagram.com/marcusfaberfdp\",\"resultsLimit\": \"5\",\"start_date\": \"01-01-2025\",\"end_date\": \"03-01-2025\",\"post_type\": \"Post\"},{\"profileurl\": \"https://www.instagram.com/meta/\",\"resultsLimit\": \"5\",\"start_date\": \"03-01-2025\",\"end_date\": \"03-17-2025\",\"post_type\": \"Post\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"

Product - Scraping Post Information:

  1. Ins - Scrape post information via profile URL

spider_id ,Associated scraper tool (required)

It defines the scraper tool to be used.

Request Example:

spider_id=ins_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=instagram.com" ^
  -d "spider_id=ins_posts_by-profileurl" ^
  -d "spider_parameters=[{\"profileurl\": \"https://www.instagram.com/marcusfaberfdp\",\"resultsLimit\": \"5\",\"start_date\": \"01-01-2025\",\"end_date\": \"03-01-2025\",\"post_type\": \"Post\"},{\"profileurl\": \"https://www.instagram.com/meta/\",\"resultsLimit\": \"5\",\"start_date\": \"03-01-2025\",\"end_date\": \"03-17-2025\",\"post_type\": \"Post\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
profileurl , Profile URL (required)

This parameter is used to specify the Instagram profile URL to scrape.

Request Example:

"profileurl": "https://www.instagram.com/marcusfaberfdp"

curl -X POST "https://scraperapi.thordata.com/builder" ^
  -H "Authorization: Bearer Token-ID" ^
  -H "Content-Type: application/x-www-form-urlencoded" ^
  -d "spider_name=instagram.com" ^
  -d "spider_id=ins_posts_by-profileurl" ^
  -d "spider_parameters=[{\"profileurl\": \"https://www.instagram.com/marcusfaberfdp\",\"resultsLimit\": \"5\",\"start_date\": \"01-01-2025\",\"end_date\": \"03-01-2025\",\"post_type\": \"Post\"},{\"profileurl\": \"https://www.instagram.com/meta/\",\"resultsLimit\": \"5\",\"start_date\": \"03-01-2025\",\"end_date\": \"03-17-2025\",\"post_type\": \"Post\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
resultsLimit ,Maximum number of posts (required)

This parameter is used to specify the maximum number of posts to scrape.

Request Example:

"resultsLimit": "5"

curl -X POST "https://scraperapi.thordata.com/builder" ^
  -H "Authorization: Bearer Token-ID" ^
  -H "Content-Type: application/x-www-form-urlencoded" ^
  -d "spider_name=instagram.com" ^
  -d "spider_id=ins_posts_by-profileurl" ^
  -d "spider_parameters=[{\"profileurl\": \"https://www.instagram.com/marcusfaberfdp\",\"resultsLimit\": \"5\",\"start_date\": \"01-01-2025\",\"end_date\": \"03-01-2025\",\"post_type\": \"Post\"},{\"profileurl\": \"https://www.instagram.com/meta/\",\"resultsLimit\": \"5\",\"start_date\": \"03-01-2025\",\"end_date\": \"03-17-2025\",\"post_type\": \"Post\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
start_date ,Start date (optional)

This parameter specifies the start date for scraping posts.

Request Example:

"start_date": "01-01-2025"

end_date ,End date (optional)

This parameter specifies the end date for scraping posts.

Request Example:

"end_date": "03-01-2025"

post_type , Post type (optional)

This parameter specifies the type of posts to scrape, either Post or Reel. Parameter values: Post Reel

Request Example:

"post_type": "Post"

  1. Ins - Scrape detailed post information via post URL

spider_id ,Associated scraper tool (required)

It defines the scraper tool to be used.

Request Example:

spider_id=ins_posts_by-posturl

posturl ,Post URL (required)

This parameter is used to specify the Instagram post URL to scrape.

Request Example:

"posturl": "https://www.instagram.com/p/Cuf4s0MNqNr"

Product - Scraping Instagram Personal Information:

  1. Ins - Scrape personal information via username

spider_id ,Associated scraper tool (required)

It defines the scraper tool to be used.

Request Example:

spider_id=ins_profiles_by-username

username , Username (required)

This parameter is used to specify the Instagram username to scrape.

Request Example:

"username": "zoobarcelona"

  1. Ins - Scrape personal information via profile URL

spider_id ,Associated scraper tool (required)

It defines the scraper tool to be used.

Request Example:

spider_id=ins_profiles_by-profileurl

profileurl , Profile URL (required)

This parameter is used to specify the Instagram profile URL to scrape.

Request Example:

"profileurl": "https://www.instagram.com/cats_of_world_/"

Product - Scraping Instagram Post Comments:

  1. Ins - Scrape post comments via post URL

spider_id ,Associated scraper tool (required)

It defines the scraper tool to be used.

Request Example:

spider_id=ins_comment_by-posturl

posturl , Post URL (required)

This parameter is used to specify the Instagram post URL to scrape.

Request Example:

"posturl": "https://www.instagram.com/cats_of_instagram/reel/C4GLo_eLO2e/"

resultsLimit ,Number of comments to scrape (required)

This parameter is used to specify the maximum number of comments to scrape.

Request Example:

"num_of_comments": "10"

isNewestComments ,Scrape latest comments (optional)

This parameter specifies whether the comments should be sorted by the latest time. Parameter values: true false

Request Example:

"isNewestComments": "true"

includeNestedComments ,Scrape replies (optional)

This parameter specifies whether to scrape replies to comments. Parameter values: true false

Request Example:

"includeNestedComments": "true"

Product - Scraping Instagram Reels Information:

  1. Ins - Scrape Reels information via URL

spider_id ,Associated scraper tool (required)

It defines the scraper tool to be used.

Request Example:

spider_id=ins_reel_by-url

url ,URL (required)

This parameter is used to specify the Instagram URL to scrape.

Request Example:

"url": "https://www.instagram.com/reel/C5Rdyj_q7YN/"

2、Ins - Scrape Reels information via list URL

spider_id ,Associated scraper tool (required)

It defines the scraper tool to be used.

Request Example:

spider_id=ins_allreel_by-url

url , URL (required)

This parameter is used to specify the Instagram list URL to scrape.

Request Example:

"url": "https://www.instagram.com/billieeilish"

num_of_posts ,Maximum number of Reels to scrape (optional)

This parameter specifies the maximum number of Reels to scrape.

Request Example:

"num_of_posts": "30"

posts_to_not_include ,Posts to exclude (optional)

This parameter specifies which Reels to exclude from scraping.

Request Example:

"posts_to_not_include": ""

start_date , Start date (optional)

This parameter specifies the start date for scraping posts, format: mm-dd-yyyy, should be before "end_date".

Request Example:

"start_date": "07-07-2025"

end_date , End date (optional)

This parameter specifies the end date for scraping posts, format: mm-dd-yyyy, should be after "start_date".

Request Example:

"end_date": "09-09-2025"

3、Ins - Scrape Reels information via URL

spider_id ,Associated scraper tool (required)

It defines the scraper tool to be used.

Request Example:

spider_id=ins_reel_by-listurl

url , URL (required)

This parameter is used to specify the Instagram URL to scrape.

Request Example:

"url": "https://www.instagram.com/espn"

num_of_posts ,Maximum number of Reels to scrape (optional)

This parameter specifies the maximum number of Reels to scrape.

Request Example:

"num_of_posts": "10"

posts_to_not_include ,Posts to exclude (optional)

This parameter specifies which Reels to exclude from scraping.

Request Example:

"posts_to_not_include": ""

start_date , Start date (optional)

This parameter specifies the start date for scraping posts, format: mm-dd-yyyy, should be before "end_date".

Request Example:

"start_date": "07-07-2025"

end_date , End date (optional)

This parameter specifies the end date for scraping posts, format: mm-dd-yyyy, should be after "start_date".

Request Example:

"end_date": "09-09-2025"

If you need further assistance, please contact us via email at support@thordata.com.

Last updated