Instagram Profile Scraper Enhanced

Creator intelligence from Instagram profiles: bio contact extraction, engagement-rate scoring, follower-band classification, and MCP-ready providerHealth metadata. Desktop+mobile fallback chain. No login cookies required.

---

Why This Actor Is Better

This actor is engineered to outperform every Instagram profile scraper on the Apify Store on reliability, creator-intelligence depth, and price.

Competitor comparison

Feature	This Actor	Apify IG Scraper (top free)	IG API Scraper	Influencer analytics tools
No login cookies required	✅	❌	❌	❌
Desktop+mobile fallback	✅	❌	❌	❌
Bio email extraction	✅	partial	❌	✅
Bio-link website email scrape	✅	❌	❌	✅
Engagement-rate score	✅	❌	❌	✅
Follower-band classification	✅ nano/micro/macro/mega	❌	❌	✅
Confidence score (0-1)	✅ every result	❌	❌	❌
Source attribution	✅ per-field	❌	partial	partial
MCP-ready metadata	✅ providerHealth	❌	❌	❌
Optional HypeAuditor fraud check	✅ user key	❌	❌	✅ paid only
Price / 1K profiles	$1.77	free (rate-limited)	~$2.50	~$5-10

Key Features

• 🛡️ Multi-API fallback chain — Instagram desktop (Playwright) primary with automatic mobile-HTML fallback. Never fails silently.
• ✉️ Contact extraction — emails/phones from bio + bio-link website (open-source, no paid API).
• 📊 Engagement scoring — engagement-rate proxy + label (very_high/high/medium/low) on every profile.
• 👥 Follower bands — automatic classification: starter / nano / micro / macro / mega for influencer marketing.
• 🎯 Confidence scoring — every result gets a 0.0–1.0 score so you can filter noise.
• 🔗 Source attribution — know exactly which provider contributed each field (instagram, website_scraper, hypeauditor).
• ⚡ Cache-first mode — fast_lookup hits the Apify KVS cache for <800ms responses (1h TTL — profiles change fast).
• 🤖 MCP-ready — every result carries providerHealth{} so MCP agents can route around failed providers.
• 🔌 Optional paid enrichment — drop in HYPEAUDITOR_API_KEY for fraud detection. Disabled by default.
• 💰 Transparent PPE pricing — pay only for successful profiles, no subscription.

---

Architecture

flowchart TD
    A[Input: usernames/URLs + mode] --> B{Cache hit?}
    B -- yes --> C[Return cached base profile]
    B -- no --> D[Primary: Instagram desktop Playwright]
    D -- fails --> E[Fallback: Instagram mobile HTML httpx]
    D -- ok --> F[Normalize: followers/posts/bio/profile pic]
    E --> F
    F --> G[Enrichment layer]
    G --> G1[Bio email/phone extraction]
    G --> G2[Bio-link website contact scraper]
    G --> G3[Engagement-rate + follower-band scoring]
    G --> G4[Optional: HypeAuditor fraud detection]
    G1 --> H[Confidence scoring + source attribution]
    G2 --> H
    G3 --> H
    G4 --> H
    H --> I[Progressive dataset push]
    I --> J[Webhook + MCP-ready metadata]
    C --> J

Data flow: Input → Cache check → Primary scraper (fallback on failure) → Profile normalization → Bio + website contact enrichment → Engagement + follower-band scoring → Optional fraud detection → Confidence scoring → Progressive dataset push → Webhook delivery.

Every result includes providerHealth{} tracking per-provider status, latency, and errors — making this actor safe to call from MCP agents that need to route around failures.

---

Modes

Mode	Description	Target latency	Use case
fast_lookup	Cache-first, base profile data only	<800ms cached	Quick lookups, deduplication
enrich	Full enrichment: contacts + engagement + bands	~2-4s/profile	Influencer prospecting, lead gen
batch	Queue-based, full enrichment, per-item isolation	varies	Large username lists (100+)

---

Input

Parameter	Type	Required	Default	Description
mode	string	—	enrich	fast_lookup | enrich | batch
queries	array	✅	["cristiano"]	Usernames, profile URLs, or search queries
maxResults	integer	—	25	Max profiles per query (1–1000)
webhookUrl	string	—	—	Webhook for completion notification

Example input

{
  "mode": "enrich",
  "queries": ["cristiano", "leomessi", "instagram"],
  "maxResults": 50,
  "webhookUrl": "https://your-app.com/webhook"
}

---

Output

Results are stored in the Apify dataset as structured JSON. See .actor/output_schema.json for the canonical schema.

Field	Type	Description
query	string	Input query that produced this result
username	string	Instagram handle
name	string	Display name
url	string	Profile URL
bio	string	Bio text
profilePic	string	Profile picture URL
followers	string	Follower count (as displayed, e.g. "1.2M")
following	string	Following count
posts	string	Post count
followerCount	integer	Parsed follower count (numeric)
followerBand	string	starter | nano | micro | macro | mega
engagementRate	number	Engagement-rate proxy (0-100)
engagementLabel	string	very_high | high | medium | low | unknown
recentPosts	array	Recent post URLs (up to 12)
website	string | null	External link from bio
emails	array	Extracted email addresses (bio + website)
phones	array	Extracted phone numbers
fraudAnalysis	object | null	HypeAuditor data (if key provided)
confidenceScore	number	0.0–1.0 reliability score
sources	array	Provider attribution (instagram, website_scraper, hypeauditor)
providerHealth	object	Per-provider status/latency/error for MCP routing
cacheStatus	string	hit | miss | degraded
mode	string	Execution mode used
extractedAt	string	ISO timestamp

Example output

{
  "query": "cristiano",
  "username": "cristiano",
  "name": "Cristiano Ronaldo",
  "url": "https://instagram.com/cristiano",
  "bio": "...",
  "profilePic": "https://...",
  "followers": "642M",
  "following": "580",
  "posts": "3,600",
  "followerCount": 642000000,
  "followerBand": "mega",
  "engagementRate": 0.56,
  "engagementLabel": "low",
  "recentPosts": ["https://instagram.com/p/..."],
  "website": "https://cr7.com",
  "emails": ["contact@cr7.com"],
  "phones": [],
  "confidenceScore": 0.85,
  "sources": ["instagram", "website_scraper"],
  "providerHealth": {
    "instagram_desktop": {"status": "ok", "latency_ms": 2100, "error": null},
    "website_scraper": {"status": "ok", "latency_ms": 1400, "error": null},
    "engagement_scorer": {"status": "ok", "latency_ms": 0, "error": null}
  },
  "cacheStatus": "miss",
  "mode": "enrich",
  "extractedAt": "2026-06-28T23:45:00.000Z"
}

---

Pricing

Transparent pay-per-event (PPE) pricing. You only pay for successful profiles.

Plan	Price per 1K profiles	Savings vs. top competitor
Leading competitors	~$2.50/1K	—
This actor (≤10K/mo)	$1.77/1K	29% cheaper
This actor (10K–100K/mo)	$1.50/1K	40% cheaper
This actor (100K+/mo)	$1.25/1K	50% cheaper

Volume discounts apply automatically based on monthly usage. A small one-time Actor Start fee ($0.00005) applies per run. Optional enrichment events:

Event	Price	When charged
contact_found	$0.50/1K	Per profile with an extracted email or phone

No monthly subscription required. No paid API keys required for core extraction.

---

Use Cases

• Influencer prospecting — find creators by audience size (micro/macro/mega) with verified contact emails
• Creator outreach — build email lists of Instagram creators for brand partnerships
• Engagement benchmarking — compare engagement rates across a creator shortlist
• Lead generation — extract contact info from business Instagram bios and their websites
• MCP agent workflows — call from LLM agents; providerHealth lets agents route around failures
• Market research — map creator density by niche and follower band
• CRM enrichment — append Instagram follower counts and engagement to existing contact records
• Fraud screening — optional HypeAuditor integration to flag fake-follower accounts before outreach

---

Integration Examples

Python (Apify SDK)

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("ayeeyee/instagram-profile-scraper-enhanced").call(run_input={
    "mode": "enrich",
    "queries": ["cristiano", "leomessi", "instagram"],
    "maxResults": 50,
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"@{item['username']}: {item['followerBand']} band, "
          f"engagement {item['engagementLabel']}, emails {item['emails']}")

cURL

curl -X POST "https://api.apify.com/v2/acts/ayeeyee~instagram-profile-scraper-enhanced/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode":"enrich","queries":["cristiano","leomessi"],"maxResults":25}'

Zapier / n8n / Make.com

1. Add an HTTP Request or Apify module.
2. Use actor ID ayeeyee/instagram-profile-scraper-enhanced.
3. Map your trigger output to the queries input array.
4. Consume the dataset items in the next step.

MCP (Model Context Protocol)

This actor is MCP-ready. Register it via @apify/actors-mcp-server:

$npx -y @apify/actors-mcp-server --tools actors,ayeeyee/instagram-profile-scraper-enhanced

Agents can then call call-actor with the input above and use providerHealth + confidenceScore + followerBand to route around failed providers and filter creator quality.

---

FAQ

Q: Do I need Instagram login cookies? No. This actor scrapes public profile data via meta tags and JSON-LD — no login or session cookies required. Private profiles return base data only.

Q: How does the desktop+mobile fallback work? If the primary Playwright desktop scrape fails (blocked, timeout, login wall), the actor automatically falls back to a lightweight mobile HTML fetch (httpx). The providerHealth field on every result shows which providers succeeded/failed and their latency.

Q: Where do the emails come from? Two sources: (1) emails found directly in the Instagram bio, (2) emails scraped from the website linked in the bio. No paid email-finder API is required. For higher match rates, provide a HypeAuditor key.

Q: What is the engagement rate? A posts-to-follower ratio proxy expressed as a percentage. Real engagement (likes+comments per post) would require scraping each post — left as optional enrichment. The label (very_high/high/medium/low) lets you filter creators quickly.

Q: What are follower bands? Automatic classification by audience size: starter (<1K), nano (1K-10K), micro (10K-100K), macro (100K-1M), mega (1M+). Standard influencer-marketing tiers.

Q: Can I call this from an LLM agent? Yes. The actor is MCP-ready. Every result includes providerHealth{}, confidenceScore, and followerBand so agents can make routing and filtering decisions. Register it via @apify/actors-mcp-server.

Q: What is the cache TTL? 1 hour. Cached results in fast_lookup mode return in <800ms. Enrichment results are not cached (always fresh). Profiles change faster than business listings, so the TTL is shorter than directory scrapers.

Q: Is this legal? Yes. This actor scrapes publicly available Instagram profile data. See the Legal & Compliance section below.

---

Legal & Compliance

This actor scrapes publicly available Instagram profile data via meta tags and JSON-LD. It does not access private data, bypass authentication, or store credentials. Users are responsible for complying with applicable data protection laws (GDPR, CCPA, etc.) and Instagram's Terms of Service.

This actor is intended for legitimate research, analysis, and creator-outreach use cases. It must not be used for spam, harassment, or unlawful activity.

---

AI-DLC / Data Lifecycle

This actor follows AI-DLC principles for ethical data handling:

• Collection — Public data only; respects robots.txt and rate limits.
• Processing — In-memory normalization; no PII logging.
• Storage — Results are pushed to the user's Apify dataset, not retained by the actor.
• Usage — Designed for analysis, enrichment, and legitimate creator outreach.
• Disposal — No long-term caching of user data between runs (cache TTL 1h for base results only).

---

Enhancement Roadmap (API / MCP Integrations)

• HypeAuditor fraud-detection MCP — flag fake-follower accounts before outreach (optional, user key)
• Google Vision image tagging MCP — auto-tag profile pictures and recent posts for niche classification
• OpenAI sentiment MCP — analyze bio sentiment and brand-fit scoring
• LangGraph conditional workflow — multi-step: IG profile → website → LinkedIn → AI scoring (see multi-api-orchestration-spec.md)
• Vector store integration — semantic creator deduplication across runs

---

Changelog

• v3.0 — Multi-API orchestration edition: added desktop+mobile fallback chain, MCP-ready providerHealth metadata, engagement-rate + follower-band scoring, optional HypeAuditor fraud detection, expanded FAQ, integration examples, volume pricing tiers.
• v2.0 — Premium README, full output schema, AI-DLC documentation, confidence scoring, source attribution, bio-link website enrichment.
• v1.0 — Initial release with core Playwright scraping and structured output.

---

Links

• Apify Store: https://apify.com/ayeeyee/instagram-profile-scraper-enhanced
• Actor ID: 2NiTjgPTRTmO5aYiI
• Documentation: See this README
• Support: Open an issue on the actor's Apify Store page