# Instagram Related Person Scraper (`scraper-engine/instagram-related-person-scraper`) Actor

The Instagram Related Person Scraper helps you discover and extract data about related or suggested Instagram accounts. Gather usernames, bios, follower counts, and profile links. Perfect for influencer research, competitor analysis, and expanding outreach with structured, actionable data.

- **URL**: https://apify.com/scraper-engine/instagram-related-person-scraper.md
- **Developed by:** [Scraper Engine](https://apify.com/scraper-engine) (community)
- **Categories:** Social media, Lead generation, Agents
- **Stats:** 297 total users, 26 monthly users, 100.0% runs succeeded, 9 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

$19.99/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

### What does Instagram Related Person Scraper do? 🤔

An Instagram Related Person Scraper is a related accounts scraper, similar users scraper, and suggested users extraction tool designed to automatically extract related profiles from Instagram. When you view a profile, Instagram often suggests related accounts based on shared followers, content similarity, or audience behavior.

Instead of manually reviewing suggestions, this Instagram related users scraper tool collects and organizes those accounts instantly. It works as a bulk Instagram related accounts scraper, helping you automate profile discovery at scale.

For marketers, researchers, and businesses, an Instagram related person scraper online is a powerful Instagram profile discovery tool and Instagram network scraper. It saves hours of manual work and delivers structured datasets for influencer research, competitor mapping, and audience analysis.

If you’ve ever searched for how to scrape related Instagram accounts automatically, or needed an automated Instagram related users extractor, this tool replaces manual browsing with reliable automation.

### 🛠️ Support and Feedback

- 🐞 **Bug reports:** Open a ticket in the repository **Issues** section  
- ✨ **Custom solutions or feature requests:** Contact our team 📧 **Email:** dev.scraperengine@gmail.com

### What Instagram Data can I extract? 📊

The Instagram Related Person Scraper app and Instagram related profiles scraping software can extract:

| Data Type | Description |
| --- | --- |
| Related Profile IDs | Unique identifiers of suggested profiles |
| Profile Usernames | Handles of related accounts |
| Profile URLs | Direct links to related accounts |
| Profile Name | Display name |
| Profile Bio | Bio text |
| Profile Category | Business, creator, personal |
| Engagement Metadata | Followers, following, post counts |

Using this Instagram bulk related users extractor, marketers can build audience graphs, researchers can analyze networks, and businesses can run automated Instagram competitor discovery scraping workflows.


#### ⭐ Key Features of Instagram Related Person Scraper

Whether you use an Instagram related person scraper free, enterprise solution, or Instagram related accounts scraping API, you get:

⚡ Bulk Extraction – Works as a bulk Instagram related accounts scraper tool, extracting hundreds of profiles per session.

📂 Organized Output – Structured export via Instagram related accounts data export tool in JSON or CSV.

🔍 Influencer Discovery – Operates as an Instagram similar accounts scraper to uncover niche influencers.

🚀 Automation Ready – Built for Instagram automation scraping related users across multiple profiles.

🛠 Developer Friendly – Available as Instagram related users API, script, or GitHub-based solution.

🌐 Multi-Access – Functions as Instagram scraping software for related accounts, web app, or extension.

📊 Research Grade – Ideal for agencies needing automated Instagram profile relationship extraction.

🔒 Policy Aware – Designed for responsible scraping within platform guidelines.

* * *
    
##🔗 What are other Instagram scraping tools?

If you want to scrape specific Instagram data, you can use any of the dedicated scrapers below for faster and more targeted results.  
Just enter Instagram usernames, profile URLs, post links, hashtags, locations, or keywords and start scraping instantly.


### How to use Instagram Related Person Scraper 🛠

Here’s how to run the Instagram related accounts extraction tool:

🔗 Enter Profile URL – Add the target Instagram profile.

📑 Select Parameters – Choose usernames, bios, metadata, or full Instagram related profiles data extraction.

▶️ Run the Scraper – Launch the automated Instagram related accounts scraper via app or API.

⏳ Processing – The system performs bulk related Instagram accounts scraping automatically.

📂 Export Results – Download CSV or JSON.

📊 Analyze – Use the dataset for growth mapping, influencer targeting, or network analysis.

Unlike unsafe shortcuts, this is a structured Instagram profile relationship scraping tool built for scalability.

* * *

### 🎯 Use Cases

An Instagram Related Person Scraper and Instagram similar profiles scraping tool supports:

📈 Digital Marketing – Run Instagram audience overlap scraping to identify competitors.

🏪 Business Intelligence – Perform automated Instagram related users scraping for niche mapping.

🎓 Academic Research – Use as a social network scraping tool for Instagram.

📊 Market Intelligence – Build datasets with bulk Instagram suggested users extraction.

👥 Growth Strategy – Discover similar audiences using Instagram related accounts discovery software.

This transforms manual browsing into structured automation.

* * *

### Why choose us? 💡

Compared to random tools or limited Instagram related person scraper free versions, our Instagram bulk related accounts scraping software stands out:

✅ High Scale – Designed for mass Instagram related accounts extraction.

🔍 Precision – Advanced Instagram similar users data scraping accuracy.

💻 Flexible Deployment – Web app, API, or downloadable Instagram related users scraping tool.

📊 Clean Export – Production-ready datasets.

🔒 Responsible Use – Built with scraping compliance awareness.

🛠 Developer Support – Comparable to enterprise-grade Instagram scraping tools for related accounts automation.

Professionals choose this solution for reliable automation without data gaps.

* * *

### How many results can you scrape with Instagram Related Person Scraper? 📈

The scalability of the Instagram Related Person Scraper allows:

• Dozens of related accounts per single profile  
• Hundreds via bulk Instagram related profile scraping automation  
• Thousands using automated Instagram network scraping workflows

For example:

A marketer runs a bulk related Instagram accounts scraper to extract 200 influencers.

An analyst performs Instagram automated related users extraction across 1,000+ profiles.

A researcher builds a large dataset using Instagram similar accounts bulk scraping software.

Whether using lightweight or enterprise tools, automation eliminates manual bottlenecks.

* * *

### Is it legal to scrape Instagram Related Persons? ⚖️

Using an Instagram Related Person Scraper is legal when extracting public data responsibly.

✔️ Allowed – Public usernames, bios, and links.  
❌ Not Allowed – Private data access or security bypass.

Best practices:

• Use tools built for ethical Instagram related accounts scraping automation.  
• Avoid unsafe bypass methods.  
• Follow platform scraping policies.

Responsible automation protects both users and businesses.

### Input Parameters 📝

Example input JSON:
```json
{
  "proxyConfiguration": {
    "useApifyProxy": true
  },
  "urls": [
    "https://www.instagram.com/ishowspeed/",
    "mrbeast"
  ],
  "max_profiles": 10
}
````

### Output Format 📂

Example JSON output:

```json
  {
    "username": "ishowspeed",
    "limit": 10,
    "related_profiles": [
      {
        "id": "288090135",
        "full_name": "Major League Soccer",
        "is_private": false,
        "is_verified": true,
        "profile_pic_url": "https://scontent-iad3-2.cdninstagram.com/v/t51.2885-19/486639052_3940094029582201_1211526993537926742_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby40NTAuYzIifQ&_nc_ht=scontent-iad3-2.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2QGdWrp_zNwFZPgeIiopy_dMu8QX1hqtkA9d0eEMjDfhMon9DDOBGHVxE2E0Fr3Czg4&_nc_ohc=uKJIIc2FDzQQ7kNvwFSeQtn&_nc_gid=wzUK9yq73hFYP38oilCl1A&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfppML-irSxMoJ8BsMj2ACpPu-hb7g2ST6F44XEz2n8rBQ&oe=6973BB2C&_nc_sid=8b3546",
        "username": "mls"
      },
      {
        "id": "6229137320",
        "full_name": "Cafu",
        "is_private": false,
        "is_verified": true,
        "profile_pic_url": "https://scontent-iad3-2.cdninstagram.com/v/t51.2885-19/482153685_1195697322129702_2044499451179788165_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-iad3-2.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2QGdWrp_zNwFZPgeIiopy_dMu8QX1hqtkA9d0eEMjDfhMon9DDOBGHVxE2E0Fr3Czg4&_nc_ohc=H0mkws9uuZAQ7kNvwGjCmwg&_nc_gid=wzUK9yq73hFYP38oilCl1A&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfrrqWp-dS-Oyxg-1hXklQW8ZPtO5JmKvWfNOe-l5IPJDw&oe=6973CBA1&_nc_sid=8b3546",
        "username": "cafu2"
      },
      {
        "id": "278193020",
        "full_name": "FaZe Clan",
        "is_private": false,
        "is_verified": true,
        "profile_pic_url": "https://scontent-iad3-2.cdninstagram.com/v/t51.2885-19/472111763_888768759998285_1747011215400138632_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby45MzAuYzIifQ&_nc_ht=scontent-iad3-2.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2QGdWrp_zNwFZPgeIiopy_dMu8QX1hqtkA9d0eEMjDfhMon9DDOBGHVxE2E0Fr3Czg4&_nc_ohc=zsKL4IYmA60Q7kNvwHPQyIb&_nc_gid=wzUK9yq73hFYP38oilCl1A&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfqWJs6Q1Swc63YZ83zLyazlZKgfb5Sf8BO8t-7g2Gta4A&oe=6973C98C&_nc_sid=8b3546",
        "username": "fazeclan"
      },
      {
        "id": "78611756476",
        "full_name": "speed clips",
        "is_private": false,
        "is_verified": false,
        "profile_pic_url": "https://scontent-iad3-2.cdninstagram.com/v/t51.2885-19/588339886_17844338178620477_1457011807589057617_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-iad3-2.cdninstagram.com&_nc_cat=105&_nc_oc=Q6cZ2QGdWrp_zNwFZPgeIiopy_dMu8QX1hqtkA9d0eEMjDfhMon9DDOBGHVxE2E0Fr3Czg4&_nc_ohc=etswMJiRDcIQ7kNvwHSYXua&_nc_gid=wzUK9yq73hFYP38oilCl1A&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_Afou5h7OOEumNZ2QI4kCPBlQI_7QQQWfIi8butRJOG8Upg&oe=6973CD46&_nc_sid=8b3546",
        "username": "w_speed0"
      },
      {
        "id": "70469061364",
        "full_name": "STREAMERS  CLIPS  DAILY",
        "is_private": false,
        "is_verified": false,
        "profile_pic_url": "https://scontent-iad3-2.cdninstagram.com/v/t51.2885-19/558475569_17891610210349365_5659746067799210097_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-iad3-2.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2QGdWrp_zNwFZPgeIiopy_dMu8QX1hqtkA9d0eEMjDfhMon9DDOBGHVxE2E0Fr3Czg4&_nc_ohc=DWfb3R8DhjIQ7kNvwFeukvU&_nc_gid=wzUK9yq73hFYP38oilCl1A&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfodIywBjiTrhOYyFRXBzMkrk_Nmq17AZdOfce4TZraSPg&oe=6973E15D&_nc_sid=8b3546",
        "username": "streamer_snaps"
      },
      {
        "id": "248935266",
        "full_name": "Mike Holston",
        "is_private": false,
        "is_verified": true,
        "profile_pic_url": "https://scontent-iad3-2.cdninstagram.com/v/t51.2885-19/509273035_18519121375039267_4814644688177491688_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-iad3-2.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2QGdWrp_zNwFZPgeIiopy_dMu8QX1hqtkA9d0eEMjDfhMon9DDOBGHVxE2E0Fr3Czg4&_nc_ohc=lSSHwt0lqcMQ7kNvwHC4auW&_nc_gid=wzUK9yq73hFYP38oilCl1A&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfqZ9V1Pah2_nsR7y69001hWdxKorYwyhQ-iTgbvzNkZtg&oe=6973DB25&_nc_sid=8b3546",
        "username": "therealtarzann"
      },
      {
        "id": "63688739912",
        "full_name": "Behruz Abdumalikov",
        "is_private": false,
        "is_verified": false,
        "profile_pic_url": "https://scontent-iad3-2.cdninstagram.com/v/t51.2885-19/422106366_739359631209144_2892723409791023423_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby42MDQuYzIifQ&_nc_ht=scontent-iad3-2.cdninstagram.com&_nc_cat=100&_nc_oc=Q6cZ2QGdWrp_zNwFZPgeIiopy_dMu8QX1hqtkA9d0eEMjDfhMon9DDOBGHVxE2E0Fr3Czg4&_nc_ohc=8EEKA4Cw498Q7kNvwGCt2ru&_nc_gid=wzUK9yq73hFYP38oilCl1A&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_Afp9Zp39PKtSALAGZNUzNwicq3-DszzMxXmf5sIN5SmqWw&oe=6973D6FE&_nc_sid=8b3546",
        "username": "khablbtm"
      },
      {
        "id": "41574851191",
        "full_name": "𝐋𝐈𝐕𝐄 HERE WE GO 🚨",
        "is_private": false,
        "is_verified": true,
        "profile_pic_url": "https://scontent-iad3-2.cdninstagram.com/v/t51.2885-19/605800494_18069136688387192_5300865370067471184_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-iad3-2.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2QGdWrp_zNwFZPgeIiopy_dMu8QX1hqtkA9d0eEMjDfhMon9DDOBGHVxE2E0Fr3Czg4&_nc_ohc=GnkY6WcpayYQ7kNvwHRK1GH&_nc_gid=wzUK9yq73hFYP38oilCl1A&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfqaPCXhv_VIm67UZaUTzEpNsXmNkqH-N0o9cvqIGM9eHQ&oe=6973C10D&_nc_sid=8b3546",
        "username": "liveherewego"
      },
      {
        "id": "2714415704",
        "full_name": "Unstoppable Business | Mindset & Sports",
        "is_private": false,
        "is_verified": true,
        "profile_pic_url": "https://scontent-iad3-2.cdninstagram.com/v/t51.2885-19/471933748_1067319922075872_6425772435414275990_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby44MDAuYzIifQ&_nc_ht=scontent-iad3-2.cdninstagram.com&_nc_cat=100&_nc_oc=Q6cZ2QGdWrp_zNwFZPgeIiopy_dMu8QX1hqtkA9d0eEMjDfhMon9DDOBGHVxE2E0Fr3Czg4&_nc_ohc=SsFNavjqbdgQ7kNvwH1jZxO&_nc_gid=wzUK9yq73hFYP38oilCl1A&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfoSq2rb-F11OBBMewdxq5w-KNeQQfFr2f62MZY0B-nPTw&oe=6973D2A9&_nc_sid=8b3546",
        "username": "unstoppable"
      },
      {
        "id": "175001080",
        "full_name": "Serhou Guirassy",
        "is_private": false,
        "is_verified": true,
        "profile_pic_url": "https://scontent-iad3-2.cdninstagram.com/v/t51.2885-19/516303494_18520509157025081_3486597622302866840_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-iad3-2.cdninstagram.com&_nc_cat=105&_nc_oc=Q6cZ2QGdWrp_zNwFZPgeIiopy_dMu8QX1hqtkA9d0eEMjDfhMon9DDOBGHVxE2E0Fr3Czg4&_nc_ohc=YlF8wQTlrNwQ7kNvwFDQriw&_nc_gid=wzUK9yq73hFYP38oilCl1A&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_Afp1_NG6UGmWbuiXZAibuMmWkArGocwm3NmNaGcrQW9EpA&oe=6973D53D&_nc_sid=8b3546",
        "username": "serhou.guirassy"
      }
    ]
  },


```

### 🔗 What are other Instagram scraping tools?

If you want to scrape specific Instagram data, you can use any of the dedicated scrapers below for faster and more targeted results.\
Just enter Instagram usernames, profile URLs, post links, hashtags, locations, or keywords and start scraping instantly.

| [📱 Instagram Profile Phone Number Scraper by Keyword](https://apify.com/scraper-engine/instagram-profile-phone-number-scraper-by-keyword) | [✨ Instagram Highlights Scraper](https://apify.com/scraper-engine/instagram-highlights-scraper) |
|---|---|
| [📝 Instagram Post Scraper](https://apify.com/scraper-engine/instagram-post-scraper) | [🎬 Instagram Reels Scraper](https://apify.com/scraper-engine/instagram-reels-scraper) |
| [🎞️ Instagram Single Reels Scraper](https://apify.com/scraper-engine/instagram-single-reels-scraper) | [📂 Instagram Profile Post Scraper](https://apify.com/scraper-engine/instagram-profile-post-scraper) |
| [📺 Instagram Profile Reels Scraper](https://apify.com/scraper-engine/instagram-profile-reels-scraper) | [👤 Instagram Profile Scraper](https://apify.com/scraper-engine/instagram-profile-scraper) |
| [📢 Instagram Mentions Scraper](https://apify.com/scraper-engine/instagram-mentions-scraper) | [📊 Instagram Followers Count Scraper](https://apify.com/scraper-engine/instagram-followers-count-scraper) |
| [🏷️ Instagram Tagged & Mentions Posts Scraper](https://apify.com/scraper-engine/instagram-tagged-and-mentions-posts-scraper) | [🔖 Instagram Tagged Posts Scraper](https://apify.com/scraper-engine/instagram-tagged-posts-scraper) |
| [📈 Instagram Related Hashtag Stats Scraper](https://apify.com/scraper-engine/instagram-related-hashtag-stats-scraper) | [💬 Instagram Comments Scraper](https://apify.com/scraper-engine/instagram-comments-scraper) |
| [📩 Instagram DM Automation](https://apify.com/scraper-engine/instagram-dm-automation) | [📍 Instagram Location Scraper](https://apify.com/scraper-engine/instagram-location-scraper) |
| [#️⃣ Instagram Hashtag Scraper](https://apify.com/scraper-engine/instagram-hashtag-scraper) | [🔥 Instagram Posts Scraper (Cheapest)](https://apify.com/scraper-engine/instagram-posts-scraper-cheapest) |
| [📧 Instagram Email Scraper](https://apify.com/scraper-engine/instagram-email-scraper) | [📨 Instagram Profile Email Scraper by Keyword](https://apify.com/scraper-engine/instagram-profile-email-scraper-by-keyword) |
| [📞 Instagram Phone Number Scraper](https://apify.com/scraper-engine/instagram-phone-number-scraper) | [☎️ Instagram Profile Phone Number Scraper](https://apify.com/scraper-engine/instagram-profile-phone-number-scraper) |
|

### 🤔 FAQ – Instagram Related Person Scraper

#### Q1: Is there an Instagram Related Person Scraper free version?

👉 Yes, some providers offer limited Instagram related users scraper free tools before paid upgrades.

#### Q2: Can I use it online without installation?

👉 Yes, many platforms provide Instagram related accounts scraper online tools.

#### Q3: Is there a GitHub project for this?

👉 Yes, developers can access Instagram related accounts scraper GitHub repositories.

#### Q4: Can I access it via API?

👉 Yes, you can integrate using an Instagram related users scraping API.

#### Q5: Does this tool scrape private accounts?

👉 No. It works only with publicly accessible data.

#### Q6: Is it built for automation?

👉 Yes, it functions as an automated Instagram related accounts scraping tool for bulk workflows.

#### Q7: Is scraping against Instagram rules?

👉 Always follow Instagram scraping policy and use automation responsibly.

# Actor input Schema

## `urls` (type: `array`):

📌 Enter one or more Instagram profiles to scrape related accounts from. Supports mixed formats:
• Full URL: https://www.instagram.com/username/
• Handle: @username
• Plain: username

Add multiple entries to map networks across several creators in one run.

## `max_profiles` (type: `integer`):

🔢 How many related profiles to fetch per input username. Higher = more data, but slower runs. Recommended sweet spot: 20–100. Maximum: 10,000.

## `proxyConfiguration` (type: `object`):

🛡️ Enable Apify Proxy for reliable scraping. Residential proxies reduce blocks and rate limits. Strongly recommended for consistent results.

## Actor input object example

```json
{
  "urls": [
    "https://www.instagram.com/ishowspeed/"
  ],
  "max_profiles": 10,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urls": [
        "https://www.instagram.com/ishowspeed/"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("scraper-engine/instagram-related-person-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "urls": ["https://www.instagram.com/ishowspeed/"],
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("scraper-engine/instagram-related-person-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "urls": [
    "https://www.instagram.com/ishowspeed/"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call scraper-engine/instagram-related-person-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=scraper-engine/instagram-related-person-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Instagram Related Person Scraper",
        "description": "The Instagram Related Person Scraper helps you discover and extract data about related or suggested Instagram accounts. Gather usernames, bios, follower counts, and profile links. Perfect for influencer research, competitor analysis, and expanding outreach with structured, actionable data.",
        "version": "0.1",
        "x-build-id": "TmHldBhGYqtiYFRfI"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/scraper-engine~instagram-related-person-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-scraper-engine-instagram-related-person-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/scraper-engine~instagram-related-person-scraper/runs": {
            "post": {
                "operationId": "runs-sync-scraper-engine-instagram-related-person-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/scraper-engine~instagram-related-person-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-scraper-engine-instagram-related-person-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "urls": {
                        "title": "🔗 Profile URLs & Usernames",
                        "type": "array",
                        "description": "📌 Enter one or more Instagram profiles to scrape related accounts from. Supports mixed formats:\n• Full URL: https://www.instagram.com/username/\n• Handle: @username\n• Plain: username\n\nAdd multiple entries to map networks across several creators in one run.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "max_profiles": {
                        "title": "📊 Max Related Profiles per User",
                        "minimum": 0,
                        "maximum": 10000,
                        "type": "integer",
                        "description": "🔢 How many related profiles to fetch per input username. Higher = more data, but slower runs. Recommended sweet spot: 20–100. Maximum: 10,000.",
                        "default": 10
                    },
                    "proxyConfiguration": {
                        "title": "🔒 Proxy & Anti-Block",
                        "type": "object",
                        "description": "🛡️ Enable Apify Proxy for reliable scraping. Residential proxies reduce blocks and rate limits. Strongly recommended for consistent results."
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```