# Instagram User Scraper · Fast & Affordable (`apidojo/instagram-user-scraper`) Actor

Extract Instagram profiles, followers, following lists, and public emails by username, URL, or ID. Get bio, verification status, follower counts, contact info. $0.02/search includes 40 FREE profiles. Export to JSON/CSV, schedule via API, integrate with workflows.

- **URL**: https://apify.com/apidojo/instagram-user-scraper.md
- **Developed by:** [API Dojo](https://apify.com/apidojo) (community)
- **Categories:** Social media, Lead generation, Other
- **Features:** Limited permissions
- **Stats:** 2,745 total users, 165 monthly users, 99.9% runs succeeded, 52 bookmarks
- **User rating**: 3.60 out of 5 stars

## Pricing

from $0.49 / 1,000 user profile items

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

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

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Instagram Profile Scraper: Ultimate Instagram User & Follower Data Extraction

Extract Instagram account details by username, URL, or user ID with transparent event-based pricing. This **Instagram profile scraper** collects Instagram profile data, follower lists, following lists, public emails, and verification status at **$0.02 per search** (first 40 users FREE!) or **$0.01 per profile**. Perfect for influencer research, lead generation, and social media intelligence—scrape Instagram account details by URL, extract Instagram username data, and get complete Instagram ID search results in structured JSON/CSV format.

💰 **Price:** $0.02/search (40 FREE users) or $0.01/profile
📊 **Data Coverage:** Profiles, followers, following, bio, emails, verification
🎁 **Free Tier:** First 40 users included per keyword search
🛡️ **No Proxy Required** | **No Login Needed** | **Event-Based Pricing**

### Quick Navigation

- [Instagram Profile Scraper: Ultimate Instagram User & Follower Data Extraction 🏯](#instagram-profile-scraper-ultimate-instagram-user--follower-data-extraction-)
  - [Quick Navigation](#quick-navigation)
  - [ℹ️ Disclaimer About This Instagram Profile Scraper](#ℹ️-disclaimer-about-this-instagram-profile-scraper)
  - [🧭 What Does Instagram Profile Scraper Do?](#-what-does-instagram-profile-scraper-do)
  - [Core Extraction Capabilities](#core-extraction-capabilities)
    - [📊 Instagram Profile Data Extraction](#-instagram-profile-data-extraction)
    - [👥 Follower & Following List Scraping](#-follower--following-list-scraping)
    - [📧 Public Email Extraction](#-public-email-extraction)
    - [🔍 Multiple Search Methods](#-multiple-search-methods)
  - [🐉 Features and Functionality](#-features-and-functionality)
    - [Core Features](#core-features)
    - [💰 Pricing: Transparent Event-Based Instagram Scraper Costs](#-pricing-transparent-event-based-instagram-scraper-costs)
  - [Pricing Structure](#pricing-structure)
    - [How Pricing Works](#how-pricing-works)
    - [💵 Real-World Instagram Scraper Pricing Examples](#-real-world-instagram-scraper-pricing-examples)
      - [Keyword Search Scenarios (Includes 40 FREE Profiles)](#keyword-search-scenarios-includes-40-free-profiles)
    - [Direct Profile Scenarios (No Free Items)](#direct-profile-scenarios-no-free-items)
    - [💡 Pro Tip](#-pro-tip)
  - [🆓 Demo Mode & Free Users](#-demo-mode--free-users)
  - [](#)
  - [🎎 Who needs this?](#-who-needs-this)
  - [](#-1)
  - [🍚 Input Parameters](#-input-parameters)
    - [](#-2)
    - [💡 Instagram Profile Scraper Input Strategy Guide](#-instagram-profile-scraper-input-strategy-guide)
    - [🎯 Strategy 1: Cost-Effective Bulk User Discovery](#-strategy-1-cost-effective-bulk-user-discovery)
    - [🎯 Strategy 2: Targeted Brand/Influencer Profile Analysis](#-strategy-2-targeted-brandinfluencer-profile-analysis)
    - [🎯 Strategy 3: Direct URL-Based Profile Extraction](#-strategy-3-direct-url-based-profile-extraction)
    - [🎯 Strategy 4: Large-Scale Follower Network Extraction](#-strategy-4-large-scale-follower-network-extraction)
    - [🎯 Strategy 5: Multi-Keyword Discovery Campaign](#-strategy-5-multi-keyword-discovery-campaign)
    - [🎯 Strategy 6: Hybrid Approach (Discovery + Deep Dive)](#-strategy-6-hybrid-approach-discovery--deep-dive)
    - [📊 Strategy Comparison Table](#-strategy-comparison-table)
    - [🧠 Pro Tips for Instagram Extractor Optimization](#-pro-tips-for-instagram-extractor-optimization)
      - [✅ Maximize Free Profiles](#-maximize-free-profiles)
      - [✅ Use maxItems Wisely](#-use-maxitems-wisely)
      - [✅ Disable Unnecessary Extraction](#-disable-unnecessary-extraction)
      - [✅ Batch Related Searches](#-batch-related-searches)
      - [✅ Keywords vs Handles Decision](#-keywords-vs-handles-decision)
  - [](#-3)
  - [📦 Output](#-output)
    - [Full Profile Output (from handles/URLs/userIds)](#full-profile-output-from-handlesurlsuserids)
    - [Follower/Following Output](#followerfollowing-output)
    - [Keyword Search Output](#keyword-search-output)
    - [Output Fields Explained](#output-fields-explained)
    - [](#-4)
    - [🧩 Custom Map Function: Transform Instagram Profile Scraper Output](#-custom-map-function-transform-instagram-profile-scraper-output)
  - [How It Works](#how-it-works)
  - [🔌 Send results straight into Notion, Todoist and more (MCP connectors)](#-send-results-straight-into-notion-todoist-and-more-mcp-connectors)
  - [🈴 Related Instagram Scrapers & Data Extraction Tools](#-related-instagram-scrapers--data-extraction-tools)
    - [📦 Complete Apidojo Instagram Scraper Ecosystem](#-complete-apidojo-instagram-scraper-ecosystem)
    - [🎯 Choose the Right Instagram Extractor for Your Use Case](#-choose-the-right-instagram-extractor-for-your-use-case)
      - [👤 Need User & Profile Data?](#-need-user--profile-data)
      - [📸 Need Posts & Media Content?](#-need-posts--media-content)
      - [💬 Need Engagement & Interactions?](#-need-engagement--interactions)
      - [#️⃣ Need Hashtag & Trend Data?](#️⃣-need-hashtag--trend-data)
      - [📍 Need Location-Based Content?](#-need-location-based-content)
  - [🎯 Who Needs This Instagram Profile Scraper? (Use Cases & Industries)](#-who-needs-this-instagram-profile-scraper-use-cases--industries)
    - [👥 Influencer Marketing Teams & Brand Partnerships](#-influencer-marketing-teams--brand-partnerships)
    - [🎯 Lead Generation Specialists & B2B Sales Teams](#-lead-generation-specialists--b2b-sales-teams)
    - [📊 Social Media Managers & Digital Marketing Agencies](#-social-media-managers--digital-marketing-agencies)
    - [🔬 Market Researchers & Data Analysts](#-market-researchers--data-analysts)
    - [🚀 Growth Hackers & Startup Founders](#-growth-hackers--startup-founders)
    - [🛍️ E-commerce Brands & Retail Businesses](#️-e-commerce-brands--retail-businesses)
  - [🔧 Troubleshooting Common Instagram Scraper Issues](#-troubleshooting-common-instagram-scraper-issues)
    - [❓ Getting Few Results?](#-getting-few-results)
    - [💰 Unexpected Costs?](#-unexpected-costs)
    - [💡 Want to Minimize Costs?](#-want-to-minimize-costs)
    - [👥 Missing Followers/Followings?](#-missing-followersfollowings)
    - [📧 No Public Email Found?](#-no-public-email-found)
    - [🔒 Private Profiles?](#-private-profiles)
    - [❌ No Results?](#-no-results)
  - [📞 Contact](#-contact)

### ℹ️ Disclaimer About This Instagram Profile Scraper

We are data extraction specialists with deep expertise in Instagram profile scraping. This **Instagram account scraper** is exceptionally fine-tuned for extracting Instagram details by username, URL, and user ID—offering you comprehensive capabilities for Instagram data extraction. We provide enterprise-grade maintenance, responsive support, and reliable Instagram scraper performance. No marketing fluff—just accurate Instagram account details and professional service.

**What makes us different:**

- ✅ Battle-tested across thousands of Instagram extraction projects -

- ✅ Direct support from the development team

- ✅ Continuous updates for Instagram API changes

### 🧭 What Does Instagram Profile Scraper Do?

This **Instagram account scraper** extracts comprehensive Instagram profile data, follower lists, and following lists from Instagram.com without requiring authentication or proxies. Use this **Instagram profile scraper** to collect **Instagram account details by username**, **Instagram details by URL**, or perform **Instagram ID search** operations at scale.

### Core Extraction Capabilities

#### 📊 Instagram Profile Data Extraction

Extract complete **Instagram account details** including username, full name, biography, follower counts, following counts, verification status, post counts, profile pictures, and website links. This **Instagram extractor** retrieves all public profile information from any Instagram account using handles, URLs, or user IDs.

#### 👥 Follower & Following List Scraping

Collect full follower and following lists from any public Instagram profile. The **Instagram username scraper** extracts each follower's profile data including username, user ID, full name, profile picture, verification status, and privacy settings—perfect for audience analysis and network mapping.

#### ⚠️ Verified Account Follower Limitation

Instagram currently limits the follower data available for **verified accounts** to the first **50 followers**. Therefore, this actor can return a maximum of **50 followers for verified accounts**, even when a higher `maxItems` value is specified.

**Non-verified accounts are not affected** and continue to support follower extraction according to the configured `maxItems` limit.

#### 📧 Public Email Extraction

Automatically extracts public business emails from Instagram profiles where available. This **Instagram account scraper** identifies and collects contact information from business profiles, enabling direct outreach for influencer marketing and lead generation.

#### 🔍 Multiple Search Methods

**Search by keywords:** Discover Instagram users matching specific search terms (most cost-effective at $0.02 per search with 40 FREE users included) **Search by handles:** Extract specific Instagram profiles using @usernames ($0.01 per profile) **Search by URLs:** Scrape Instagram account details by URL using direct profile links ($0.01 per URL) **Search by IDs:** Perform **Instagram ID search** using numeric user IDs ($0.01 per ID)

### 🐉 Features and Functionality

Apidojo's **Instagram profile scraper** combines cost-effective pricing with powerful extraction capabilities. Get complete **Instagram account details by username**, URL, or ID with transparent event-based billing and enterprise-grade features.

#### Core Features

| Feature                        | Description                                                                                     | Benefit                                                         |
| ------------------------------ | ----------------------------------------------------------------------------------------------- | --------------------------------------------------------------- |
| 💰 **Event-Based Pricing**      | Pay only for profiles you actually scrape—no subscriptions, no monthly fees                     | Cost control: Only pay for what you extract                     |
| 🎁 **40 Free Users Per Search** | Every keyword search includes first 40 Instagram profiles at no extra charge                    | Budget-friendly: $0.02 gets you 40 complete profiles            |
| 🔍 **4 Search Methods**         | Extract via keywords, @handles, user IDs, or direct Instagram URLs                              | Flexibility: Choose the most efficient method for your use case |
| 👥 **Follower/Following Lists** | Complete extraction of follower and following lists with full profile details                   | Network analysis: Map connections and audience overlap          |
| 📧 **Public Email Detection**   | Automatically extracts business emails from Instagram profiles where available                  | Lead generation: Direct contact info for outreach campaigns     |
| 📊 **50+ Profile Data Points**  | Bio, follower counts, verification status, post counts, website, contact info, profile pictures | Comprehensive data: Everything you need for influencer analysis |
| 🛡️ **Zero Authentication**      | No Instagram cookies, no login credentials, no account required                                 | Safe & simple: Start scraping immediately without setup         |
| 🔧 **Custom Map Function**      | JavaScript function to transform, filter, or enrich output data on-the-fly                      | Data control: Shape results to match your exact requirements    |
| ✨ **Structured Output**        | Clean JSON/CSV export ready for databases, spreadsheets, or APIs                                | Integration-ready: Import directly into your tools              |
| 🚀 **No Proxy Needed**          | Direct Instagram data access without residential or datacenter proxies                          | Cost savings: No proxy fees, simplified infrastructure          |

#### 💰 Pricing: Transparent Event-Based Instagram Scraper Costs

Apidojo's **Instagram profile scraper** uses transparent pay-per-use pricing—no subscriptions, no hidden fees, no monthly minimums. Extract **Instagram account details by username**, URL, or keyword search with crystal-clear costs calculated per query and per profile.

**Free users**: Limited to **5 runs per month**, each capped at **10 items**.

### Pricing Structure

| Query Type           | Base Cost             | What's Included                            | Best For                                                  |
| -------------------- | --------------------- | ------------------------------------------ | --------------------------------------------------------- |
| 🔍 **Keyword Search** | **$0.02** per search  | **40 FREE Instagram profiles** (2 pages)   | Bulk user discovery, influencer research, lead generation |
| 👤 **Direct Profile** | **$0.01** per profile | Profile data only (followers cost extra)   | Specific account analysis, targeted extraction            |
| 📊 **Dataset Items**  | **$0.0005** per item  | Each additional profile/follower/following | Large-scale follower extraction, network mapping          |

#### How Pricing Works

**Keyword Search (Most Cost-Effective):** When you use the `keywords` parameter to search Instagram users, you pay $0.02 per search query—and the first 40 user profiles are **completely free**. Additional profiles beyond 40 cost $0.0005 each.

**Direct Profile Access:** When you use `handles`, `userIds`, or `startUrls` to fetch specific Instagram profiles, you pay $0.01 per profile. Follower and following extraction costs $0.0005 per user—no free items included with direct queries.

**Follower/Following Extraction:** Every follower or following profile counts as a dataset item at $0.0005. For keyword searches, the first 40 items are free. For direct profile queries, all followers/followings are charged.

***

#### 💵 Real-World Instagram Scraper Pricing Examples

##### Keyword Search Scenarios (Includes 40 FREE Profiles)

| Use Case         | Profiles Extracted | Total Cost | Cost Per Profile |
| ---------------- | ------------------ | ---------- | ---------------- |
| Small test run   | 40 users           | **$0.02**  | $0.0005          |
| Medium dataset   | 100 users          | **$0.05**  | $0.0005          |
| Large campaign   | 1,000 users        | **$0.50**  | $0.0005          |
| Enterprise scale | 10,000 users       | **$5.02**  | $0.0005          |

**Calculation:** 1 query ($0.02) + (total profiles - 40 free) × $0.0005

#### Direct Profile Scenarios (No Free Items)

| Use Case                       | Configuration                             | Total Cost | Breakdown                         |
| ------------------------------ | ----------------------------------------- | ---------- | --------------------------------- |
| **Single influencer analysis** | 1 profile + 50 followers                  | **$0.036** | $0.01 + (51 × $0.0005)            |
| **Competitor audit**           | 1 profile + 100 followers + 100 following | **$0.111** | $0.01 + (201 × $0.0005)           |
| **Multi-brand research**       | 5 profiles + 100 followers each           | **$0.305** | ($0.01 × 5) + (505 × $0.0005)     |
| **Agency-scale analysis**      | 10 profiles + 200 followers each          | **$1.11**  | ($0.01 × 10) + (2,010 × $0.0005)  |
| **Network mapping**            | 50 profiles + 500 followers each          | **$13.00** | ($0.01 × 50) + (25,050 × $0.0005) |

#### 💡 Pro Tip

Use **keyword search** instead of direct handles when possible! Keyword searches include the first 40 users for FREE, making bulk user discovery incredibly cost-effective - perfect for lead generation and influencer research.

### 🆓 Demo Mode & Free Users

If you run on Apify's Free plan, you can still use this **Instagram profile scraper** in Demo Mode. **Free users can run the actor up to 5 times per month**, with each run capped at a maximum of 10 items — just enough to test it out. For unrestricted usage and to unlock the full power of **Instagram user scraping**, subscribe to a paid Apify plan at [apify.com/pricing](https://apify.com/pricing?fpr=yhdrb).

##

### 🎎 Who needs this?

- **Influencer Marketers**: Find and analyze Instagram influencers at scale with detailed follower/following data at just $0.02 per search (40 users FREE!).
- **Lead Generation Specialists**: Build prospect lists from Instagram users with cost-effective keyword searches - 40 free users per query.
- **Social Media Managers**: Track competitor followers, analyze audience overlap, and discover trending profiles at $0.01 per profile.
- **Market Researchers**: Collect structured Instagram user data for demographic analysis and trend identification affordably.
- **Growth Hackers**: Identify high-engagement users and build targeted outreach lists efficiently with transparent pricing.
- **E-commerce & Brands**: Discover potential brand ambassadors and track follower growth patterns cost-effectively.
- **Data Analysts**: Extract large-scale Instagram user datasets for social network analysis and ML models at $0.0005 per user.

##

### 🍚 Input Parameters

| Field             | Type    | Description                                                                                                                                                                                                      | Default value |
| ----------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- |
| keywords          | array   | Search keywords to find Instagram users. Uses **List Query** pricing ($0.02 per search, first 40 users FREE). Most cost-effective option for bulk user discovery.                                                | `[]`          |
| handles           | array   | Instagram usernames (e.g., "selenagomez"). Uses **Single Item Query** pricing ($0.01 per handle + $0.0005 per item). No free items included.                                                                     | `[]`          |
| startUrls         | array   | Instagram profile URLs. Uses **Single Item Query** pricing ($0.01 per URL + $0.0005 per item). No free items included.                                                                                           | `[]`          |
| userIds           | array   | Instagram user IDs to scrape. Uses **Single Item Query** pricing ($0.01 per ID + $0.0005 per item). No free items included.                                                                                      | `[]`          |
| getFollowers      | boolean | If enabled, extracts followers of each profile. Followers count as dataset items ($0.0005 each). Free for first 40 items in keyword searches only.                                                               | `true`        |
| getFollowings     | boolean | If enabled, extracts following list of each profile. Followings count as dataset items ($0.0005 each). Free for first 40 items in keyword searches only.                                                         | `true`        |
| maxItems          | number  | Maximum number of items (users/followers/followings) to extract. Controls your total costs.                                                                                                                      | `Infinity`    |
| customMapFunction | string  | JavaScript function to transform each output user profile. Synchronous, plain JavaScript only, about 1 second per item. **Not for filtering** - filtering may result in automatic restrictions. Ignored with a warning if it is not a usable function. | `null`        |
| outputConnector   | string  | MCP connector to deliver the results to — pick one (see [Send results straight into Notion, Todoist and more](#-send-results-straight-into-notion-todoist-and-more-mcp-connectors)).                          | `null`        |
| deliverTarget     | string  | Where the connector writes — paste the URL or ID (Notion example: `https://www.notion.so/My-Posts-24f8a1b2c3d44e5f8a9b0c1d2e3f4a5b`); some services need none.                                                | `null`        |
| deliverMode       | string  | `perPost` (one record per scraped item) or `summary` (one roll-up per run).                                                                                                                                      | `perPost`     |
| deliverMaxItems   | number  | Optional cap on how many records `perPost` delivers (ignored in `summary`).                                                                                                                                      | `null`        |

####

##### 💡 Instagram Profile Scraper Input Strategy Guide

Choose the right extraction method to optimize costs and get exactly the **Instagram account details** you need. Each approach—keyword search, handle-based extraction, or URL scraping—serves different use cases for this **Instagram profile scraper**.

***

#### 🎯 Strategy 1: Cost-Effective Bulk User Discovery

**Best for:** Lead generation, influencer research, competitor audience analysis, market research

**Method:** Keyword search (includes 40 FREE profiles per search)

json

```json
{
  "keywords": ["fashion", "fitness", "tech"],
  "maxItems": 1000,
  "getFollowers": false,
  "getFollowings": false
}
```

| Cost Component          | Calculation                 | Amount      |
| ----------------------- | --------------------------- | ----------- |
| 3 keyword searches      | 3 × $0.02                   | **$0.06**   |
| 880 additional profiles | (1000 - 120 free) × $0.0005 | **$0.44**   |
| **Total Cost**          |                             | **$0.50**   |
| **Cost per profile**    |                             | **$0.0005** |

**What you get:**

- ✅ 1,000 Instagram user profiles matching your keywords
- ✅ Usernames, bio, follower counts, verification status
- ✅ Profile pictures, websites, contact info
- ✅ Perfect for building prospecting lists at scale

**Why this works:** Keyword searches include 40 free profiles each (120 total free!), making bulk **Instagram username scraping** extremely cost-effective.

***

#### 🎯 Strategy 2: Targeted Brand/Influencer Profile Analysis

**Best for:** Competitor analysis, influencer vetting, brand monitoring, audience overlap studies

**Method:** Direct handle extraction with follower lists

json

```json
{
  "handles": ["nike", "adidas"],
  "maxItems": 100,
  "getFollowers": true,
  "getFollowings": false
}
```

| Cost Component       | Calculation                            | Amount                      |
| -------------------- | -------------------------------------- | --------------------------- |
| 2 profile queries    | 2 × $0.01                              | **$0.02**                   |
| 102 dataset items    | (2 profiles + 100 followers) × $0.0005 | **$0.051**                  |
| **Total Cost**       |                                        | **$0.071**                  |
| **Cost per profile** |                                        | **$0.036** (with followers) |

**What you get:**

- ✅ Complete Nike and Adidas profile data
- ✅ Up to 100 of their followers with full profile details
- ✅ Follower usernames, bio, verification status, follower counts
- ✅ Perfect for analyzing competitor audiences

**Why this works:** Extract specific **Instagram account details by username** when you know exactly which profiles matter—ideal for competitive intelligence.

***

#### 🎯 Strategy 3: Direct URL-Based Profile Extraction

**Best for:** Scraping from saved lists, external databases, spreadsheet imports, CRM integrations

**Method:** Full profile URLs with comprehensive follower/following data

json

```json
{
  "startUrls": [
    "https://www.instagram.com/taylorswift/",
    "https://www.instagram.com/selenagomez/"
  ],
  "maxItems": 100,
  "getFollowers": true,
  "getFollowings": true
}
```

| Cost Component       | Calculation                                          | Amount                         |
| -------------------- | ---------------------------------------------------- | ------------------------------ |
| 2 URL queries        | 2 × $0.01                                            | **$0.02**                      |
| 102 dataset items    | (2 profiles + 50 followers + 50 following) × $0.0005 | **$0.051**                     |
| **Total Cost**       |                                                      | **$0.071**                     |
| **Cost per profile** |                                                      | **$0.036** (with network data) |

**What you get:**

- ✅ Complete Taylor Swift and Selena Gomez profile data
- ✅ Up to 50 followers + 50 following accounts per profile
- ✅ Full network mapping data with relationship context
- ✅ Perfect for social network analysis and influence mapping

**Why this works:** **Instagram details by URL** extraction integrates seamlessly with existing workflows—paste URLs directly from spreadsheets or databases.

***

#### 🎯 Strategy 4: Large-Scale Follower Network Extraction

**Best for:** Social network analysis, audience overlap studies, influencer network mapping

**Method:** Direct profiles with high follower extraction limits

json

```json
{
  "handles": ["cristiano"],
  "maxItems": 10000,
  "getFollowers": true,
  "getFollowings": false
}
```

| Cost Component        | Calculation                             | Amount      |
| --------------------- | --------------------------------------- | ----------- |
| 1 profile query       | 1 × $0.01                               | **$0.01**   |
| 10,000 dataset items  | (1 profile + 9,999 followers) × $0.0005 | **$5.00**   |
| **Total Cost**        |                                         | **$5.01**   |
| **Cost per follower** |                                         | **$0.0005** |

**What you get:**

- ✅ Cristiano Ronaldo's complete profile data
- ✅ 10,000 follower profiles with usernames, bios, verification
- ✅ Massive dataset for machine learning or audience analysis
- ✅ Perfect for enterprise-scale social intelligence

**Why this works:** High-volume **Instagram account scraper** operations remain affordable at half a cent per follower—ideal for data science projects.

***

#### 🎯 Strategy 5: Multi-Keyword Discovery Campaign

**Best for:** Building large prospecting databases, comprehensive market research, niche discovery

**Method:** Multiple broad keywords with profile-only extraction

json

```json
{
  "keywords": [
    "entrepreneur", "startup founder", "ceo",
    "business coach", "marketing expert", "sales"
  ],
  "maxItems": 5000,
  "getFollowers": false,
  "getFollowings": false
}
```

| Cost Component            | Calculation                 | Amount      |
| ------------------------- | --------------------------- | ----------- |
| 6 keyword searches        | 6 × $0.02                   | **$0.12**   |
| 4,760 additional profiles | (5000 - 240 free) × $0.0005 | **$2.38**   |
| **Total Cost**            |                             | **$2.50**   |
| **Cost per profile**      |                             | **$0.0005** |

**What you get:**

- ✅ 5,000 Instagram profiles matching business/marketing keywords
- ✅ 240 profiles completely free (40 per search × 6 searches)
- ✅ Comprehensive B2B prospecting database
- ✅ Perfect for lead generation at scale

**Why this works:** Strategic keyword selection maximizes the 40-free-profiles benefit—6 searches = 240 free profiles before paying for additional data.

***

#### 🎯 Strategy 6: Hybrid Approach (Discovery + Deep Dive)

**Best for:** Comprehensive campaigns combining discovery and detailed analysis

**Method:** Keyword discovery followed by targeted follower extraction

**Step 1: Discovery Phase**

json

```json
{
  "keywords": ["fitness influencer"],
  "maxItems": 100,
  "getFollowers": false,
  "getFollowings": false
}
```

**Cost:** $0.05 → Get 100 fitness influencer profiles

**Step 2: Deep Analysis Phase**

json

```json
{
  "handles": ["top_10_handles_from_step_1"],
  "maxItems": 1000,
  "getFollowers": true,
  "getFollowings": false
}
```

**Cost:** $0.60 → Get 10 detailed profiles + 1,000 total followers

**Total Campaign Cost:** $0.65 for discovery + detailed analysis

**Why this works:** Combine cheap keyword discovery with targeted deep dives—find the right accounts first, then extract comprehensive data only for qualified profiles.

***

#### 📊 Strategy Comparison Table

| Strategy                   | Best For            | Profiles | Followers | Total Cost | Cost/Profile |
| -------------------------- | ------------------- | -------- | --------- | ---------- | ------------ |
| **Keyword Bulk**           | Lead generation     | 1,000    | 0         | $0.50      | $0.0005      |
| **Handle + Followers**     | Competitor analysis | 2        | 100       | $0.071     | $0.036       |
| **URL Scraping**           | CRM integration     | 2        | 100       | $0.071     | $0.036       |
| **Large Follower Extract** | Network analysis    | 1        | 10,000    | $5.01      | $0.0005      |
| **Multi-Keyword**          | Market research     | 5,000    | 0         | $2.50      | $0.0005      |
| **Hybrid Campaign**        | Comprehensive intel | 110      | 1,000     | $0.65      | $0.006       |

***

#### 🧠 Pro Tips for Instagram Extractor Optimization

##### ✅ Maximize Free Profiles

Each keyword search includes **40 FREE profiles**. Instead of searching "tech startup," try separate searches for "tech," "startup," "saas"—get 120 free profiles instead of 40.

##### ✅ Use maxItems Wisely

Set `maxItems` to control costs. For testing, use `maxItems: 50`. For production, calculate your budget: `maxItems = (budget - query_cost) / 0.0005`.

##### ✅ Disable Unnecessary Extraction

- **Profiles only?** Set both `getFollowers: false` and `getFollowings: false`
- **Followers only?** Set `getFollowings: false`
- **Save 50-90% on costs** by extracting only what you need

##### ✅ Batch Related Searches

Combine similar keywords in one run rather than multiple separate runs to minimize query costs.

##### ✅ Keywords vs Handles Decision

- **Don't know specific accounts?** Use keywords ($0.02 per search, 40 free)
- **Have exact username list?** Use handles ($0.01 per profile, no free items)
- **Rule of thumb:** Keywords are cheaper for discovering 40+ users

##

### 📦 Output

Output is stored in a dataset. Each item represents an Instagram user profile with comprehensive information:

#### Full Profile Output (from handles/URLs/userIds)

```json
{
  "type": "user",
  "isAvailable": true,
  "id": "1644335255",
  "username": "techstartups",
  "fullName": "Tech Startups™️",
  "profilePicUrl": "https://scontent-sjc6-1.cdninstagram.com/...",
  "isPrivate": false,
  "isVerified": false,
  "postCount": 1401,
  "followerCount": 106950,
  "followingCount": 227,
  "biography": "Daily tech news and startup insights",
  "website": "http://techstartups.com/",
  "hasVideos": true,
  "totalReelsCount": 1,
  "hasGuides": false,
  "bioLinks": [
    {
      "url": "http://techstartups.com/",
      "title": "",
      "type": "external",
      "id": 17986690912596804
    }
  ],
  "isBusiness": false,
  "category": null,
  "cityName": "",
  "zip": "",
  "publicEmail": "contact@techstartups.com",
  "contactPhoneNumber": "",
  "publicPhoneCountryCode": "",
  "publicPhoneNumber": "",
  "hasPrivateCollections": true,
  "isMemorialized": false,
  "isWhatsappLinked": false,
  "followers": [],
  "followings": []
}
```

#### Follower/Following Output

```json
{
  "type": "user",
  "isAvailable": true,
  "id": "38092762173",
  "username": "john.developer",
  "fullName": "John Developer",
  "profilePicUrl": "https://scontent-lax3-1.cdninstagram.com/...",
  "isPrivate": true,
  "isVerified": false,
  "related": "https://www.instagram.com/techstartups/"
}
```

#### Keyword Search Output

```json
{
  "type": "user",
  "isAvailable": true,
  "id": "23678829",
  "username": "marketing_guru",
  "fullName": "Marketing Expert",
  "profilePicUrl": "https://scontent-sjc6-1.cdninstagram.com/...",
  "isPrivate": false,
  "isVerified": true
}
```

#### Output Fields Explained

| Field              | Description                                            |
| ------------------ | ------------------------------------------------------ |
| type               | Always "user" for user profiles                        |
| id                 | Instagram user ID                                      |
| username           | Instagram handle (@username)                           |
| fullName           | Display name on profile                                |
| biography          | Profile bio text                                       |
| followerCount      | Total number of followers                              |
| followingCount     | Total number of accounts followed                      |
| isVerified         | Blue checkmark verification status                     |
| isPrivate          | Whether the account is private                         |
| profilePicUrl      | Profile picture URL (high quality)                     |
| website            | Website/link in bio                                    |
| publicEmail        | Public business email (if available)                   |
| postCount          | Total number of posts                                  |
| totalReelsCount    | Total number of reels posted                           |
| bioLinks           | Array of bio links with URLs and metadata              |
| isBusiness         | Whether account is a business profile                  |
| category           | Business category (if business account)                |
| hasVideos          | Whether profile has video content                      |
| contactPhoneNumber | Public contact phone (if available)                    |
| followers          | Array of follower profiles (if getFollowers enabled)   |
| followings         | Array of following profiles (if getFollowings enabled) |
| related            | Related profile URL (for followers/followings)         |

###

#### 🧩 Custom Map Function: Transform Instagram Profile Scraper Output

Transform and customize your **Instagram profile scraper** output data using the `customMapFunction` parameter. This JavaScript function receives each Instagram user object and returns your desired format.

***

### How It Works

The custom map function accepts each user profile object as input and returns your transformed data structure. Use it to customize **Instagram account details** output format, calculate custom metrics, or reformat fields.

**Important:** Custom map function is for data transformation—**not for filtering**. Filtering items may result in automatic restrictions.

```javascript
(object) => ({
  ...object,
  username: object.username?.toUpperCase(),
  influencerScore: object.followerCount / (object.followingCount + 1),
  contactEmail: object.biography?.match(/[\w.-]+@[\w.-]+\.\w+/)?.[0],
  biography: undefined  // Remove bio from output
})
```

**Example transformation:**

```json
// Input:
{
  "username": "nike",
  "followerCount": 250000000,
  "followingCount": 150,
  "biography": "Contact: marketing@nike.com"
}

// Output:
{
  "username": "NIKE",
  "followerCount": 250000000,
  "followingCount": 150,
  "influencerScore": 1666666.67,
  "contactEmail": "marketing@nike.com"
}
```

#### Requirements & Error Handling

The value must be a **single JavaScript function** that takes one user profile (or follower/following) and returns the transformed profile. Arrow functions and regular functions both work; `async` and generator functions are not supported.

**Limits:** the function runs in an isolated sandbox. It must be synchronous and finish within about 1 second per item, and only plain JavaScript is available (no network requests, `require` or `console`). Each item is passed in as plain JSON data.

**An unusable function never stops your run.** The actor logs a warning, ignores the function, and saves the original, unmodified items instead-so you still get your data:

| Situation | What happens |
| --------- | ------------ |
| Not valid JavaScript (for example, plain text pasted into the field) | Rejected before the first request; original items are saved |
| Valid JavaScript but not a function (for example, an object) | Rejected before the first request; original items are saved |
| `async` or generator function | Rejected before the first request; original items are saved |
| Returns a Promise (for example, `(object) => Promise.resolve(object)`) | Rejected at that point; the remaining items are saved unmodified |
| Returns something other than an object (for example, a number or `null`) | Rejected at that point; the remaining items are saved unmodified |
| Throws while transforming an item | Rejected at that point; the remaining items are saved unmodified |
| Takes longer than about 1 second on one item (for example, an endless loop) | Rejected at that point; the remaining items are saved unmodified |

If your output does not look transformed, check the run log for a warning that starts with `Your "customMapFunction" input was rejected:`-it explains exactly what was wrong.

If you do not need to transform the output, simply leave this field empty.

### 🔌 Send results straight into Notion, Todoist and more (MCP connectors)

Skip the manual exports — the scraper can deliver its results directly into the tools you already work in, through [Apify MCP Connectors](https://apify.com/store/collections/mcp-connectors?fpr=yhdrb):

1. Authorize a connector (Notion, Todoist, or any service whose MCP server offers non-destructive write tools) once in [Console → Settings → API & Integrations → MCP connectors](https://console.apify.com/settings/integrations).
2. Pick it from the **Send results to Notion, Todoist, …** dropdown.
3. Fill in where and how to write:
   - **Destination target** — paste the URL or ID (Notion example: `https://www.notion.so/My-Posts-24f8a1b2c3d44e5f8a9b0c1d2e3f4a5b`); share it with your connector first via Notion's **••• → Connections** menu. (Some services need no target.)
   - **Write mode** — `perPost` writes one record per scraped item; `summary` writes a single roll-up for the run.
   - **Max records to deliver** *(optional)* — cap on how many records `perPost` delivers.

**Notion, structured like a spreadsheet:** point the target at a Notion **page** and the Actor auto-creates a database with one correctly-typed column per profile field (URL, number, text). An **existing database** fills the columns it already has (matched by name); an **empty database** receives only the title, with the rest of each record in the row body. Nested fields are flattened too (e.g. `bioLinks` becomes a comma-joined column), and the full record is kept in each row's page body.

Your credentials stay yours: the Actor only talks to your services through your own authorized connector and only uses non-destructive write tools — it cannot delete or overwrite anything you already have. Delivery is best-effort and runs after scraping: if it fails or the connector is misconfigured, the run still finishes successfully with all results intact and a warning in the log. If the run is about to time out, delivery stops early and the log tells you how many records were delivered.

### 🈴 Related Instagram Scrapers & Data Extraction Tools

Expand your **Instagram data extraction** capabilities with our complete suite of specialized **Instagram scrapers**. Each tool focuses on specific Instagram data types for comprehensive social media intelligence.

***

#### 📦 Complete Apidojo Instagram Scraper Ecosystem

| Tool                                                                                               | What It Extracts                                         | Best For                                                                   |
| -------------------------------------------------------------------------------------------------- | -------------------------------------------------------- | -------------------------------------------------------------------------- |
| 🏯 **Instagram Profile Scraper**                                                                    | User profiles, followers, following lists, public emails | Influencer research, lead generation, audience analysis **(You are here)** |
| 📸 **[Instagram Scraper](https://apify.com/apidojo/instagram-scraper?fpr=yhdrb)**                   | Posts, media, images, videos, captions                   | Content analysis, competitor monitoring, media collection                  |
| 💬 **[Instagram Comments Scraper](https://apify.com/apidojo/instagram-comments-scraper?fpr=yhdrb)** | Comments, engagement data, user interactions             | Sentiment analysis, engagement tracking, community insights                |
| #️⃣ **[Instagram Hashtag Scraper](https://apify.com/apidojo/instagram-hashtag-scraper?fpr=yhdrb)**   | Hashtag posts, trending content, campaign tracking       | Hashtag research, trend monitoring, campaign performance                   |
| 📍 **[Instagram Location Scraper](https://apify.com/apidojo/instagram-location-scraper?fpr=yhdrb)** | Location-based posts, geo-tagged content                 | Local marketing, location intelligence, regional analysis                  |

***

#### 🎯 Choose the Right Instagram Extractor for Your Use Case

##### 👤 Need User & Profile Data?

→ **Instagram Profile Scraper** (this tool)
Extract profiles, followers, following lists, verification status, public emails, bios

##### 📸 Need Posts & Media Content?

→ **[Instagram Scraper](https://apify.com/apidojo/instagram-scraper?fpr=yhdrb)**
Extract posts, images, videos, captions, likes, post metadata

##### 💬 Need Engagement & Interactions?

→ **[Instagram Comments Scraper](https://apify.com/apidojo/instagram-comments-scraper?fpr=yhdrb)**
Extract comments, replies, user engagement, sentiment data

##### #️⃣ Need Hashtag & Trend Data?

→ **[Instagram Hashtag Scraper](https://apify.com/apidojo/instagram-hashtag-scraper?fpr=yhdrb)**
Extract posts by hashtag, trending content, campaign tracking

##### 📍 Need Location-Based Content?

→ **[Instagram Location Scraper](https://apify.com/apidojo/instagram-location-scraper?fpr=yhdrb)**
Extract geo-tagged posts, location intelligence, regional content

### 🎯 Who Needs This Instagram Profile Scraper? (Use Cases & Industries)

Extract **Instagram account details by username**, URL, or keyword to power your social media intelligence, lead generation, and competitive research. This **Instagram scraper** serves professionals across multiple industries who need reliable **Instagram data extraction** at scale.

***

#### 👥 Influencer Marketing Teams & Brand Partnerships

**What you can do:**

- Find and analyze Instagram influencers at scale with detailed follower/following data
- Discover potential brand ambassadors matching your target demographics
- Vet influencer profiles for verification status, engagement patterns, and audience quality
- Track follower growth patterns and profile changes over time
- Build influencer databases with contact information for outreach campaigns

**Why this Instagram account scraper works:**

- **Cost-effective discovery:** $0.02 per keyword search includes 40 FREE Instagram profiles
- **Comprehensive data:** Bio, follower counts, verification status, public emails, website links
- **Bulk extraction:** Search "fashion influencer" once, get hundreds of qualified profiles
- **No authentication needed:** Start scraping immediately without Instagram login

***

#### 🎯 Lead Generation Specialists & B2B Sales Teams

**What you can do:**

- Build prospect lists from Instagram users matching your ideal customer profile
- Extract public business emails and contact information from Instagram profiles
- Discover decision-makers, founders, and executives on Instagram
- Create targeted outreach lists based on bio keywords, follower counts, and profile data
- Identify potential clients through keyword-based user discovery

**Why this Instagram username scraper works:**

- **Transparent pricing:** 40 free users per search makes bulk prospecting affordable
- **Contact extraction:** Automatically captures public emails from business profiles
- **Structured output:** Clean JSON/CSV format ready for CRM import
- **Scalable:** Extract thousands of profiles for just $0.0005 per user

***

#### 📊 Social Media Managers & Digital Marketing Agencies

**What you can do:**

- Track competitor followers and analyze audience overlap between brands
- Monitor follower growth and profile changes across competitor accounts
- Discover trending profiles and emerging influencers in your industry
- Analyze competitor following lists to identify partnership opportunities
- Build comprehensive social media intelligence reports for clients

**Why this Instagram extractor works:**

- **Follower/following extraction:** Get complete network data with one click
- **Direct profile access:** $0.01 per profile for targeted competitor analysis
- **No proxy required:** Direct Instagram data access without infrastructure costs
- **Batch processing:** Analyze multiple competitor profiles simultaneously

***

#### 🔬 Market Researchers & Data Analysts

**What you can do:**

- Collect structured Instagram user datasets for demographic analysis
- Extract large-scale profile data for social network analysis and ML models
- Identify trends and patterns across Instagram user segments
- Build training datasets for machine learning and AI projects
- Perform statistical analysis on Instagram user behavior and demographics

**Why this Instagram profile scraper works:**

- **Volume pricing:** $0.0005 per user enables datasets of 100K+ profiles affordably
- **Structured data:** Consistent JSON/CSV output ready for analysis tools
- **Custom transformation:** Map function lets you format data for your exact requirements
- **Reliable extraction:** Get complete, accurate profile data at scale

***

#### 🚀 Growth Hackers & Startup Founders

**What you can do:**

- Identify high-engagement users and build targeted outreach lists
- Discover early adopters and potential brand advocates in your niche
- Find micro-influencers for cost-effective marketing partnerships
- Build community contact lists for product launches and campaigns
- Analyze competitor audiences to refine your target market

**Why this Instagram account scraper works:**

- **Startup-friendly pricing:** Start at just $0.02 with 40 free profiles per search
- **Budget control:** Set `maxItems` to cap spending per extraction run
- **Fast execution:** Get results immediately without technical setup
- **Event-based billing:** Pay only for profiles actually extracted—no subscriptions

***

#### 🛍️ E-commerce Brands & Retail Businesses

**What you can do:**

- Discover potential brand ambassadors and user-generated content creators
- Track follower growth patterns and customer engagement on Instagram
- Find customers posting about your products or competitors' products
- Build influencer partnership lists for product launches and campaigns
- Analyze competitor audiences to identify market opportunities

**Why this Instagram scraper works:**

- **User discovery:** Keyword search finds users discussing relevant products/topics
- **Contact extraction:** Public emails enable direct partnership outreach
- **Profile verification:** Identify verified accounts for premium partnerships
- **Cost transparency:** Know exactly what you'll pay before extracting data

### 🔧 Troubleshooting Common Instagram Scraper Issues

Having trouble with your **Instagram profile scraper** extraction? Here are solutions to common issues when scraping **Instagram account details by username**, URL, or keyword search.

***

#### ❓ Getting Few Results?

**Problem:** Extraction returns fewer Instagram profiles than expected

**Solutions:**

- ✅ Check your `maxItems` setting—increase the limit if you need more profiles
- ✅ Ensure your search terms aren't too restrictive or niche
- ✅ Try broader keywords for Instagram username discovery
- ✅ Verify your input parameters are correctly formatted
- ✅ Remember Free Plan limits — Free users are limited to **5 runs per month**, each capped at **10 items**

***

#### 💰 Unexpected Costs?

**Problem:** Your **Instagram account scraper** run cost more than anticipated

**Key pricing differences to remember:**

| Method                  | Base Cost         | Free Items Included | Follower/Following Cost    |
| ----------------------- | ----------------- | ------------------- | -------------------------- |
| **Keyword searches**    | $0.02 per search  | ✅ 40 FREE users     | $0.0005 each (after 40)    |
| **Direct handles/URLs** | $0.01 per profile | ❌ NO free items     | $0.0005 each (ALL charged) |

**Cost control tips:**

- Keyword searches include 40 FREE Instagram profiles per query
- Direct handle/URL queries do NOT include free items
- Each follower/following extracted costs $0.0005
- Use `maxItems` parameter to set hard spending limits

***

#### 💡 Want to Minimize Costs?

**Problem:** Looking for the most cost-effective **Instagram extractor** approach

**Cost optimization strategies:**

✅ **Use `keywords` instead of `handles` for bulk discovery**

- Keyword method: 40 free items per search
- Handle method: 0 free items
- Savings: Up to 95% cheaper for user discovery

✅ **Disable follower/following extraction if only profile data needed**

- Set `getFollowers: false` to skip follower extraction
- Set `getFollowings: false` to skip following extraction
- Only extract what you actually need—saves $0.0005 per user

✅ **Set `maxItems` to control volume**

- Prevents runaway extraction costs on large follower lists
- Caps total extraction at your budget limit

***

#### 👥 Missing Followers/Followings?

**Problem:** **Instagram account details** don't include follower or following lists

**Solution:** Ensure both parameters are set to `true` in your input configuration:

json

```json
{
  "getFollowers": true,
  "getFollowings": true
}
```

If still missing, verify the target Instagram profiles are public (private accounts restrict follower visibility).

***

#### 📧 No Public Email Found?

**Problem:** Instagram profile scraper didn't extract email addresses

**Why this happens:**

- ✅ Public emails are **only available for business accounts** that have added contact information
- ✅ **Not all Instagram profiles have public emails**—personal accounts typically don't display email publicly
- ✅ Some business accounts choose not to add public contact info

**This is expected behavior—not a scraper error.**

***

#### 🔒 Private Profiles?

**Problem:** Cannot extract data from private Instagram accounts

**Limitation:** Private Instagram accounts cannot be scraped unless you're following them. This **Instagram username scraper** does **not support authentication** (no login, no cookies).

**Workaround:**

- Only scrape public Instagram profiles
- Verify accounts are public before adding to extraction list
- Focus on verified and business accounts (typically public)

***

#### ❌ No Results?

**Problem:** **Instagram scraper** returns zero profiles

**Troubleshooting checklist:**

- ✅ Verify your usernames are spelled correctly (case-sensitive)
- ✅ Ensure Instagram profile URLs are formatted correctly
- ✅ Confirm the profiles are **public** (not private)
- ✅ Check that accounts haven't been deleted or suspended
- ✅ Test with known public accounts first (e.g., major brands)

**Correct URL format:**

```
✅ https://www.instagram.com/username/
❌ instagram.com/username (missing https://)
❌ https://www.instagram.com/@username/ (no @ symbol in URLs)**No results?** Verify your usernames/URLs are correct and the profiles are public.
```

### 📞 Contact

If you need any sort of support, please send an email to <apidojo10@gmail.com>. You name it, we get it.

# Actor input Schema

## `startUrls` (type: `array`):

URLs to start with. It can be only User URL.

## `userIds` (type: `array`):

User IDs to be scraped.

## `handles` (type: `array`):

User Handles to be scraped.

## `keywords` (type: `array`):

Keywords that user wants to search on Instagram

## `getFollowers` (type: `boolean`):

If selected, the actor will also scrape followers of the given Instagram profiles.

## `getFollowings` (type: `boolean`):

If selected, the actor will also scrape followed profiles of the given Instagram profiles.

## `maxItems` (type: `integer`):

Maximum number of items that you want as output.

## `customMapFunction` (type: `string`):

JavaScript function to transform each output user profile (including followers and followings). Use to add computed fields, modify values, or remove unnecessary data. NOT intended for filtering - filtering may result in automatic bans. Must be a single synchronous function, e.g. (object) => { return {...object} }. It runs in a sandbox with plain JavaScript only (no network, require or console) and about 1 second per item. Leave empty if you do not need to transform the output - an unusable function is ignored and the original items are saved instead.

## `outputConnector` (type: `string`):

Pick an MCP connector you authorized in Console → Settings → API & Integrations → MCP connectors (e.g. Notion, Todoist — any service whose MCP server offers non-destructive write tools works best-effort). The scraped results are written through your own connector — the Actor never sees your third-party credentials. Only non-destructive write tools are used; it can never delete or overwrite your existing data.

## `deliverTarget` (type: `string`):

Where to write into the connector — paste the URL or ID. Notion example: https://www.notion.so/My-Posts-24f8a1b2c3d44e5f8a9b0c1d2e3f4a5b. Leave empty for services that need no target (e.g. Todoist Inbox, Slack). For Notion, share the page or database with your connector first (Notion's ••• → Connections menu), and point at a PAGE for structured columns (the Actor builds the database for you) — an empty database receives only the title (the rest of each record goes to the row's body).

## `deliverMode` (type: `string`):

perPost writes one record per scraped item; summary writes a single roll-up for the run.

## `deliverMaxItems` (type: `integer`):

Cap on how many records perPost mode writes to the connector; ignored in summary mode. Leave empty to deliver everything scraped.

## Actor input object example

```json
{
  "startUrls": [
    "https://www.instagram.com/taylorswift/"
  ],
  "getFollowers": true,
  "getFollowings": false,
  "maxItems": 1000,
  "customMapFunction": "(object) => { return {...object} }",
  "deliverMode": "perPost"
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

# 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 = {
    "startUrls": [
        "https://www.instagram.com/taylorswift/"
    ],
    "maxItems": 1000,
    "customMapFunction": (object) => { return {...object} }
};

// Run the Actor and wait for it to finish
const run = await client.actor("apidojo/instagram-user-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 = {
    "startUrls": ["https://www.instagram.com/taylorswift/"],
    "maxItems": 1000,
    "customMapFunction": "(object) => { return {...object} }",
}

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

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

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

```

## CLI example

```bash
echo '{
  "startUrls": [
    "https://www.instagram.com/taylorswift/"
  ],
  "maxItems": 1000,
  "customMapFunction": "(object) => { return {...object} }"
}' |
apify call apidojo/instagram-user-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,apidojo/instagram-user-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/lezdhAFfa4H5zAb2A/builds/V4eTSyYwcQPn7ZgoC/openapi.json
