# 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:

<details>

<summary><code>token</code> <strong>，Access token (required)</strong></summary>

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

**Request Example:**

`Bearer ********************************`

```sh
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}}"
```

</details>

**Product - Scraping Post Information:**

1. Ins - Scrape post information via profile URL

<details>

<summary><code>spider_id</code> ，<strong>Associated scraper tool (required)</strong></summary>

It defines the scraper tool to be used.

**Request Example:**

`spider_id=ins_posts_by-profileurl`

```sh
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}}"
```

</details>

<details>

<summary><code>profileurl</code> ， <strong>Profile URL (required)</strong></summary>

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

**Request Example:**

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

```sh
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}}"
```

</details>

<details>

<summary><code>resultsLimit</code> ，<strong>Maximum number of posts (required)</strong></summary>

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

**Request Example:**

`"resultsLimit": "5"`

```sh
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}}"
```

</details>

<details>

<summary><code>start_date</code> ，<strong>Start date (optional)</strong></summary>

This parameter specifies the start date for scraping posts.

**Request Example:**

`"start_date": "01-01-2025"`

```sh
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}}"
```

</details>

<details>

<summary><code>end_date</code> ，<strong>End date (optional)</strong></summary>

This parameter specifies the end date for scraping posts.

**Request Example:**

`"end_date": "03-01-2025"`

```sh
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}}"
```

</details>

<details>

<summary><code>post_type</code> ， <strong>Post type (optional)</strong></summary>

This parameter specifies the type of posts to scrape, either Post or Reel.\
Parameter values: `Post` `Reel`&#x20;

**Request Example:**

`"post_type": "Post"`

```sh
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}}"
```

</details>

2. Ins - Scrape detailed post information via post URL

<details>

<summary><code>spider_id</code> ，<strong>Associated scraper tool (required)</strong></summary>

It defines the scraper tool to be used.

**Request Example:**

`spider_id=ins_posts_by-posturl`

```sh
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-posturl" ^
  -d "spider_parameters=[{\"posturl\": \"https://www.instagram.com/p/Cuf4s0MNqNr\"},{\"posturl\": \"https://www.instagram.com/p/Cuvy6JbtyQ6\"},{\"posturl\": \"https://www.instagram.com/cats_of_instagram/reel/DBtVmu3zD6V/\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

<details>

<summary><code>posturl</code> ，<strong>Post URL (required)</strong></summary>

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

**Request Example:**

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

```sh
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-posturl" ^
  -d "spider_parameters=[{\"posturl\": \"https://www.instagram.com/p/Cuf4s0MNqNr\"},{\"posturl\": \"https://www.instagram.com/p/Cuvy6JbtyQ6\"},{\"posturl\": \"https://www.instagram.com/cats_of_instagram/reel/DBtVmu3zD6V/\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

**Product - Scraping Instagram Personal Information:**

1. Ins - Scrape personal information via username

<details>

<summary><code>spider_id</code> ，<strong>Associated scraper tool (required)</strong></summary>

It defines the scraper tool to be used.

**Request Example:**

`spider_id=ins_profiles_by-username`

```sh
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_profiles_by-username" ^
  -d "spider_parameters=[{\"username\": \"zoobarcelona\"},{\"username\": \"marcusfaberfdp\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

<details>

<summary><code>username</code> ， <strong>Username (required)</strong></summary>

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

**Request Example:**

`"username": "zoobarcelona"`

```sh
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_profiles_by-username" ^
  -d "spider_parameters=[{\"username\": \"zoobarcelona\"},{\"username\": \"marcusfaberfdp\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

2. Ins - Scrape personal information via profile URL

<details>

<summary><code>spider_id</code> ，<strong>Associated scraper tool (required)</strong></summary>

It defines the scraper tool to be used.

**Request Example:**

`spider_id=ins_profiles_by-profileurl`

```sh
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_profiles_by-profileurl" ^
  -d "spider_parameters=[{\"profileurl\": \"https://www.instagram.com/cats_of_world_/\"},{\"profileurl\": \"https://www.instagram.com/dogsofinstagram/\"},{\"profileurl\": \"https://www.instagram.com/marcusfaberfdp\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

<details>

<summary><code>profileurl</code> ， <strong>Profile URL (required)</strong></summary>

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

**Request Example:**

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

```sh
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_profiles_by-profileurl" ^
  -d "spider_parameters=[{\"profileurl\": \"https://www.instagram.com/cats_of_world_/\"},{\"profileurl\": \"https://www.instagram.com/dogsofinstagram/\"},{\"profileurl\": \"https://www.instagram.com/marcusfaberfdp\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

**Product - Scraping Instagram Post Comments:**

1. Ins - Scrape post comments via post URL

<details>

<summary><code>spider_id</code> ，<strong>Associated scraper tool (required)</strong></summary>

It defines the scraper tool to be used.

**Request Example:**

`spider_id=ins_comment_by-posturl`

```sh
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_comment_by-posturl" ^
  -d "spider_parameters=[{\"posturl\": \"https://www.instagram.com/cats_of_instagram/reel/C4GLo_eLO2e/\",\"num_of_comments\": \"10\",\"isNewestComments\": \"true\",\"includeNestedComments\": \"true\"},{\"posturl\": \"https://www.instagram.com/catsofinstagram/p/CesFC7JLyFl/?img_index=1\",\"num_of_comments\": \"10\",\"isNewestComments\": \"true\",\"includeNestedComments\": \"true\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

<details>

<summary><code>posturl</code> ， <strong>Post URL (required)</strong></summary>

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/"`

```sh
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_comment_by-posturl" ^
  -d "spider_parameters=[{\"posturl\": \"https://www.instagram.com/cats_of_instagram/reel/C4GLo_eLO2e/\",\"num_of_comments\": \"10\",\"isNewestComments\": \"true\",\"includeNestedComments\": \"true\"},{\"posturl\": \"https://www.instagram.com/catsofinstagram/p/CesFC7JLyFl/?img_index=1\",\"num_of_comments\": \"10\",\"isNewestComments\": \"true\",\"includeNestedComments\": \"true\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

<details>

<summary><code>resultsLimit</code> ，<strong>Number of comments to scrape (required)</strong></summary>

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

**Request Example:**

`"num_of_comments": "10"`

```sh
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_comment_by-posturl" ^
  -d "spider_parameters=[{\"posturl\": \"https://www.instagram.com/cats_of_instagram/reel/C4GLo_eLO2e/\",\"num_of_comments\": \"10\",\"isNewestComments\": \"true\",\"includeNestedComments\": \"true\"},{\"posturl\": \"https://www.instagram.com/catsofinstagram/p/CesFC7JLyFl/?img_index=1\",\"num_of_comments\": \"10\",\"isNewestComments\": \"true\",\"includeNestedComments\": \"true\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

<details>

<summary><code>isNewestComments</code> ，<strong>Scrape latest comments (optional)</strong></summary>

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

**Request Example:**

`"isNewestComments": "true"`

```sh
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_comment_by-posturl" ^
  -d "spider_parameters=[{\"posturl\": \"https://www.instagram.com/cats_of_instagram/reel/C4GLo_eLO2e/\",\"num_of_comments\": \"10\",\"isNewestComments\": \"true\",\"includeNestedComments\": \"true\"},{\"posturl\": \"https://www.instagram.com/catsofinstagram/p/CesFC7JLyFl/?img_index=1\",\"num_of_comments\": \"10\",\"isNewestComments\": \"true\",\"includeNestedComments\": \"true\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

<details>

<summary><code>includeNestedComments</code> ，<strong>Scrape replies (optional)</strong></summary>

This parameter specifies whether to scrape replies to comments.\
Parameter values: `true` `false`&#x20;

**Request Example:**

`"includeNestedComments": "true"`

```sh
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_comment_by-posturl" ^
  -d "spider_parameters=[{\"posturl\": \"https://www.instagram.com/cats_of_instagram/reel/C4GLo_eLO2e/\",\"num_of_comments\": \"10\",\"isNewestComments\": \"true\",\"includeNestedComments\": \"true\"},{\"posturl\": \"https://www.instagram.com/catsofinstagram/p/CesFC7JLyFl/?img_index=1\",\"num_of_comments\": \"10\",\"isNewestComments\": \"true\",\"includeNestedComments\": \"true\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

**Product - Scraping Instagram Reels Information:**

1. Ins - Scrape Reels information via URL

<details>

<summary><code>spider_id</code> ，<strong>Associated scraper tool (required)</strong></summary>

It defines the scraper tool to be used.

**Request Example:**

`spider_id=ins_reel_by-url`

```sh
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_reel_by-url" ^
  -d "spider_parameters=[{\"url\": \"https://www.instagram.com/reel/C5Rdyj_q7YN/\"},{\"url\": \"https://www.instagram.com/reel/C85BZjeSHuO\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

<details>

<summary><code>url</code> ，<strong>URL (required)</strong></summary>

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

**Request Example:**

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

```sh
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_reel_by-url" ^
  -d "spider_parameters=[{\"url\": \"https://www.instagram.com/reel/C5Rdyj_q7YN/\"},{\"url\": \"https://www.instagram.com/reel/C85BZjeSHuO\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

2、Ins - Scrape Reels information via list URL

<details>

<summary><code>spider_id</code> ，<strong>Associated scraper tool (required)</strong></summary>

It defines the scraper tool to be used.

**Request Example:**

`spider_id=ins_allreel_by-url`

```sh
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_allreel_by-url" ^
  -d "spider_parameters=[{\"url\": \"https://www.instagram.com/billieeilish\",\"num_of_posts\": \"30\",\"posts_to_not_include\": \"\",\"start_date\": \"07-07-2025\",\"end_date\": \"09-09-2025\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

<details>

<summary><code>url</code> ， <strong>URL (required)</strong></summary>

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

**Request Example:**

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

```sh
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_allreel_by-url" ^
  -d "spider_parameters=[{\"url\": \"https://www.instagram.com/billieeilish\",\"num_of_posts\": \"30\",\"posts_to_not_include\": \"\",\"start_date\": \"07-07-2025\",\"end_date\": \"09-09-2025\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

<details>

<summary><code>num_of_posts</code> ，<strong>Maximum number of Reels to scrape (optional)</strong></summary>

This parameter specifies the maximum number of Reels to scrape.

**Request Example:**

`"num_of_posts": "30"`

```sh
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_allreel_by-url" ^
  -d "spider_parameters=[{\"url\": \"https://www.instagram.com/billieeilish\",\"num_of_posts\": \"30\",\"posts_to_not_include\": \"\",\"start_date\": \"07-07-2025\",\"end_date\": \"09-09-2025\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

<details>

<summary><code>posts_to_not_include</code> ，<strong>Posts to exclude (optional)</strong></summary>

This parameter specifies which Reels to exclude from scraping.

**Request Example:**

`"posts_to_not_include": ""`

```sh
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_allreel_by-url" ^
  -d "spider_parameters=[{\"url\": \"https://www.instagram.com/billieeilish\",\"num_of_posts\": \"30\",\"posts_to_not_include\": \"\",\"start_date\": \"07-07-2025\",\"end_date\": \"09-09-2025\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

<details>

<summary><code>start_date</code> ， <strong>Start date (optional)</strong></summary>

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"`

```sh
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_allreel_by-url" ^
  -d "spider_parameters=[{\"url\": \"https://www.instagram.com/billieeilish\",\"num_of_posts\": \"30\",\"posts_to_not_include\": \"\",\"start_date\": \"07-07-2025\",\"end_date\": \"09-09-2025\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

<details>

<summary><code>end_date</code> ， <strong>End date (optional)</strong></summary>

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"`

```sh
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_allreel_by-url" ^
  -d "spider_parameters=[{\"url\": \"https://www.instagram.com/billieeilish\",\"num_of_posts\": \"30\",\"posts_to_not_include\": \"\",\"start_date\": \"07-07-2025\",\"end_date\": \"09-09-2025\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

3、Ins - Scrape Reels information via URL

<details>

<summary><code>spider_id</code> ，<strong>Associated scraper tool (required)</strong></summary>

It defines the scraper tool to be used.

**Request Example:**

`spider_id=ins_reel_by-listurl`

```sh
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_reel_by-listurl" ^
  -d "spider_parameters=[{\"url\": \"https://www.instagram.com/espn\",\"num_of_posts\": \"10\",\"posts_to_not_include\": \"\",\"start_date\": \"07-07-2025\",\"end_date\": \"09-09-2025\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

<details>

<summary><code>url</code> ，  <strong>URL (required)</strong></summary>

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

**Request Example:**

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

```sh
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_reel_by-listurl" ^
  -d "spider_parameters=[{\"url\": \"https://www.instagram.com/espn\",\"num_of_posts\": \"10\",\"posts_to_not_include\": \"\",\"start_date\": \"07-07-2025\",\"end_date\": \"09-09-2025\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

<details>

<summary><code>num_of_posts</code> ，<strong>Maximum number of Reels to scrape (optional)</strong></summary>

This parameter specifies the maximum number of Reels to scrape.

**Request Example:**

`"num_of_posts": "10"`

```sh
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_reel_by-listurl" ^
  -d "spider_parameters=[{\"url\": \"https://www.instagram.com/espn\",\"num_of_posts\": \"10\",\"posts_to_not_include\": \"\",\"start_date\": \"07-07-2025\",\"end_date\": \"09-09-2025\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

<details>

<summary><code>posts_to_not_include</code> ，<strong>Posts to exclude (optional)</strong></summary>

This parameter specifies which Reels to exclude from scraping.

**Request Example:**

`"posts_to_not_include": ""`

```sh
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_reel_by-listurl" ^
  -d "spider_parameters=[{\"url\": \"https://www.instagram.com/espn\",\"num_of_posts\": \"10\",\"posts_to_not_include\": \"\",\"start_date\": \"07-07-2025\",\"end_date\": \"09-09-2025\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

<details>

<summary><code>start_date</code> ， <strong>Start date (optional)</strong></summary>

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"`

```sh
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_reel_by-listurl" ^
  -d "spider_parameters=[{\"url\": \"https://www.instagram.com/espn\",\"num_of_posts\": \"10\",\"posts_to_not_include\": \"\",\"start_date\": \"07-07-2025\",\"end_date\": \"09-09-2025\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

<details>

<summary><code>end_date</code> ， <strong>End date (optional)</strong></summary>

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"`

```sh
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_reel_by-listurl" ^
  -d "spider_parameters=[{\"url\": \"https://www.instagram.com/espn\",\"num_of_posts\": \"10\",\"posts_to_not_include\": \"\",\"start_date\": \"07-07-2025\",\"end_date\": \"09-09-2025\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

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

<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.thordata.com/doc/scraping/web-scraper-api/parameter-description/instagram-scraping-parameters.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.