📸 Ultimate Instagram Profile & Search + AI

Fast, reliable, and comprehensive Instagram extraction for public profiles, Posts, Reels, carousels, multi-lane campaign & creator search, and optional AI content intelligence.

---

🚀 Key Capabilities

👤 1. Profile Mode (Known Targets)

• Scrape Known Profiles: Extract public metadata, bios, follower counts, and verified status for any username (e.g. natgeo, @nasa) or profile URL.
• Unified Timeline: Merges timeline feed posts and Reels clips chronologically (newest first).
• Per-Profile Limits: Control exact retrieval limits per account (latestPosts).
• All Media Types: Extract single photos, video posts, Reels clips, and multi-slide carousels with direct CDN links and child items.

🔍 2. Search & Discovery Mode (No Usernames Needed)

• Topic & Keyword Search: Find public Instagram posts, Reels, and creators by entering keywords, topics, or campaign phrases.
• Hashtag Search: Collect public content across target hashtags with multi-lane retrieval.
• Audience / Follower Thresholds: Filter discovered creators with minFollowers (e.g. 2000 for micro-influencer discovery).
• Account Exclusions: Exclude brand-owned accounts, official channels, or competitors from discovery results.
• Provenance Tracking: Every discovered post includes provenance details showing which query or hashtag surfaced it.

🧠 3. Optional AI Content Intelligence & Campaign Monitoring

• Automated Content Analysis: Generate summaries, sentiment classification, detected topics, brands, and promotion classification.
• Campaign & Activation Verification: Detect target marketing initiatives, tournaments, sponsorships, and hashtag compliance with evidence explanations.

---

⚡ Quick Start

Mode A: Scrape Specific Profiles

1. Enter Profiles: Provide Instagram usernames in profiles (e.g. ["natgeo", "nasa"]).
2. Set Limit: Choose how many items to collect per profile with latestPosts (default 10).
3. Run the Actor: Click Start to collect chronological posts and Reels.

Mode B: Search Campaign Content & Creators

1. Enter Keywords or Hashtags: Specify target signals in discoveryKeywords (e.g. ["travel vlog", "sustainable fashion"]) or discoveryHashtags (e.g. ["travel", "fitness"]).
2. Set Minimum Followers: Optionally filter creators with minFollowers (e.g. 2000).
3. Exclude Accounts: Exclude brand accounts or competitors in excludedAccounts.
4. (Optional) Enable AI: Toggle aiAnalysis or campaignDetection for automated intelligence.
5. Run the Actor: Click Start to discover matching campaign content and unknown creators.

---

📥 Input Parameters Reference

Parameter	Type	Default	Description
profiles	string[]	[]	List of Instagram usernames (e.g., natgeo, @nasa) or profile URLs. Optional when using Search/Discovery.
discoveryHashtags	string[]	[]	Hashtags to search public content and creators without knowing usernames in advance.
discoveryKeywords	string[]	[]	Keywords, topics, or campaign phrases to search relevant content and creators.
minFollowers	integer	0	Minimum follower count required for discovered creator profiles.
excludedAccounts	string[]	[]	List of usernames to exclude from discovery results (e.g. official brand accounts).
maxDiscoveryResults	integer	50	Maximum number of discovered items to return.
latestPosts	integer	10	Maximum number of latest items to collect per profile in profile mode.
includePosts	boolean	true	Include standard feed posts (photos, video posts, carousels).
includeReels	boolean	true	Include Reels video clips.
onlyPostsNewerThan	string	null	Filter items by creation date using ISO date or relative duration (e.g. 24 hours, 3 days, 7 days, 30 days).
aiAnalysis	boolean	false	Enable AI content intelligence (summaries, sentiment, topics, brands, promotion classification).
campaignDetection	boolean	false	Enable target campaign detection across scraped posts.
campaigns	array	[]	Target campaign monitoring definitions.
proxyConfiguration	object	{ "useApifyProxy": true }	Network proxy configuration for scraping resilience.

---

🧠 Optional AI Content Intelligence

When aiAnalysis is enabled, each qualifying item is enriched with structured content intelligence:

• Summary: Concise factual overview of the post caption and media context.
• Language: Primary language detected (e.g. en, es, id).
• Sentiment: Content tone (positive, neutral, negative, mixed).
• Topics: Extracted theme keywords (e.g. technology, travel, fitness).
• Brands: Detected brand names and corporate mentions.
• Promotion Detection: Identifies whether the post is commercial or promotional (isPromotion: true/false).
• Promotion Type: Classification (sponsorship, affiliate, direct_ad, giveaway, event, organic_none).
• Confidence: Assessment confidence score ($0.0 - 1.0$).

---

🏆 Custom Campaign Monitoring

Track specific influencer activations, hashtag campaigns, or partner promotions by adding campaign definitions to campaigns:

[
  {
    "name": "Summer Tech Launch",
    "brand": "TechCorp",
    "keywords": ["SummerLaunch", "NextGen", "unboxing", "review"],
    "hashtags": ["#TechCorpSummer", "#NextGen2026"],
    "additionalContext": "Official summer product launch campaign"
  }
]

When a post matches your criteria, the output includes:

• matched: true / false
• campaignName: Name of the matched campaign
• brand: Associated brand
• matchType: exact, keyword, semantic, or none
• evidence: Matching keywords, hashtags, or phrases found in the content
• reason: Clear explanation for the classification

---

📤 Output Dataset Format

Each item in the dataset is a clean, normalized record:

{
  "platform": "instagram",
  "type": "reel",
  "id": "3865503563578017023",
  "shortCode": "DWlBwLBEwT_",
  "url": "https://www.instagram.com/reel/DWlBwLBEwT_/",
  "ownerId": "12571835781",
  "ownerUsername": "travel_creator",
  "ownerFullName": "Alex Travel & Adventure",
  "caption": "Exploring hidden islands this summer! #travel #adventure #explore",
  "hashtags": ["#travel", "#adventure", "#explore"],
  "mentions": [],
  "timestamp": "2026-08-25T14:30:00.000Z",
  "mediaType": "clips",
  "displayUrl": "https://scontent.cdninstagram.com/.../img.jpg",
  "thumbnailUrl": "https://scontent.cdninstagram.com/.../thumb.jpg",
  "videoUrl": "https://scontent.cdninstagram.com/.../video.mp4",
  "images": [
    "https://scontent.cdninstagram.com/.../img.jpg"
  ],
  "likesCount": 8420,
  "commentsCount": 112,
  "videoViewCount": 45000,
  "videoPlayCount": 45000,
  "taggedUsers": [],
  "collaborators": [],
  "location": {
    "name": "Maldives",
    "slug": "maldives"
  },
  "isSponsored": false,
  "scrapedAt": "2026-08-26T08:00:00.000Z",
  "creatorProfile": {
    "id": "12571835781",
    "username": "travel_creator",
    "fullName": "Alex Travel & Adventure",
    "biography": "Travel photographer & storyteller ✈️",
    "followersCount": 45200,
    "followingCount": 380,
    "postsCount": 240,
    "isVerified": true,
    "isPrivate": false
  },
  "discoveryProvenance": {
    "lane": "keyword",
    "query": "travel",
    "matchedSignals": ["travel", "#travel"]
  },
  "relevanceScore": 0.95
}

---

💰 Pay-Per-Event (PPE) Pricing

Service	Price per Event	Price per 1,000 Results
Base Instagram Result	$0.0025	$2.50
Optional AI Intelligence	+$0.0020	+$2.00

• Charges apply strictly once per successfully scraped and delivered content item.
• Filtered candidates, private accounts with zero items, and duplicate records are never charged.
• When AI is disabled (aiAnalysis = false), zero AI charges occur.

---

🛡️ Limitations & Best Practices

• Public Content Only: Extracts publicly available posts, reels, and metadata from public profiles and discovery surfaces. Private accounts and login-required features (Stories, direct messages) are not supported.
• Platform Availability: Public fields and engagement counts reflect publicly visible data at the time of scraping.
• Budget Limits: You can configure spending limits in your Apify Console task settings to control total spend on large scraping runs.