Instagram scrapper

Action ID: instagram_scrapper

Description

Scrape an Instagram user.

Input Parameters

Name	Type	Required	Default	Description
user_name	string	✓	-	The username of the Instagram user.

View JSON Schema

Input Schema

{
  "description": "Instagram scrapper node input.",
  "properties": {
    "user_name": {
      "description": "The username of the Instagram user.",
      "title": "Instagram username",
      "type": "string"
    }
  },
  "required": [
    "user_name"
  ],
  "title": "InstagramScrapperNodeInput",
  "type": "object"
}

Output Parameters

Name	Type	Description
id	string	The ID of the Instagram user
user_name	string	The username of the Instagram user
full_name	string	The full name of the Instagram user
biography	string	The biography of the Instagram user
external_url	string	The external URL of the Instagram user
followers_count	integer	The number of followers of the Instagram user
follows_count	integer	The number of follows of the Instagram user
has_channel	boolean	Whether the Instagram user has a channel
highlight_reel_count	integer	The number of highlight reels of the Instagram user
is_business_account	boolean	Whether the Instagram user is a business account
joined_recently	boolean	Whether the Instagram user joined recently
business_category_name	string	The business category name of the Instagram user (optional)
private	boolean	Whether the Instagram user is private
profile_pic_url	string	The URL of the profile picture of the Instagram user
profile_pic_url_hd	string	The URL of the profile picture of the Instagram user in high definition
posts_count	integer	The number of posts of the Instagram user
latest_posts	array	The latest posts of the Instagram user

View JSON Schema

{
  "description": "Instagram scrapper node output.",
  "properties": {
    "id": {
      "description": "The ID of the Instagram user.",
      "title": "ID",
      "type": "string"
    },
    "user_name": {
      "description": "The username of the Instagram user.",
      "title": "Username",
      "type": "string"
    },
    "full_name": {
      "description": "The full name of the Instagram user.",
      "title": "Full name",
      "type": "string"
    },
    "biography": {
      "description": "The biography of the Instagram user.",
      "title": "Biography",
      "type": "string"
    },
    "external_url": {
      "description": "The external URL of the Instagram user.",
      "title": "External URL",
      "type": "string"
    },
    "followers_count": {
      "description": "The number of followers of the Instagram user.",
      "title": "Followers count",
      "type": "integer"
    },
    "follows_count": {
      "description": "The number of follows of the Instagram user.",
      "title": "Follows count",
      "type": "integer"
    },
    "has_channel": {
      "description": "Whether the Instagram user has a channel.",
      "title": "Has channel",
      "type": "boolean"
    },
    "highlight_reel_count": {
      "description": "The number of highlight reels of the Instagram user.",
      "title": "Highlight reel count",
      "type": "integer"
    },
    "is_business_account": {
      "description": "Whether the Instagram user is a business account.",
      "title": "Is business account",
      "type": "boolean"
    },
    "joined_recently": {
      "description": "Whether the Instagram user joined recently.",
      "title": "Joined recently",
      "type": "boolean"
    },
    "business_category_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "The business category name of the Instagram user.",
      "title": "Business category name"
    },
    "private": {
      "description": "Whether the Instagram user is private.",
      "title": "Is private",
      "type": "boolean"
    },
    "profile_pic_url": {
      "description": "The URL of the profile picture of the Instagram user.",
      "title": "Profile picture URL",
      "type": "string"
    },
    "profile_pic_url_hd": {
      "description": "The URL of the profile picture of the Instagram user in high definition.",
      "title": "Profile picture URL HD",
      "type": "string"
    },
    "posts_count": {
      "description": "The number of posts of the Instagram user.",
      "title": "Posts count",
      "type": "integer"
    },
    "latest_posts": {
      "description": "The latest posts of the Instagram user.",
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Latest posts",
      "type": "array"
    }
  },
  "required": [
    "id",
    "user_name",
    "full_name",
    "biography",
    "external_url",
    "followers_count",
    "follows_count",
    "has_channel",
    "highlight_reel_count",
    "is_business_account",
    "joined_recently",
    "private",
    "profile_pic_url",
    "profile_pic_url_hd",
    "posts_count",
    "latest_posts"
  ],
  "title": "InstagramScrapperNodeOutput",
  "type": "object"
}

How It Works

This node connects to Instagram's public data to retrieve comprehensive profile information for a specified username. It fetches account metadata including follower counts, bio information, business status, and recent posts, then returns all this data in a structured format that can be used for analysis, monitoring, or integration with other workflow nodes.

Usage Examples

Example 1: Influencer Profile Analysis

Input:

user_name: "natgeo"

Output:

id: "25025320"
user_name: "natgeo"
full_name: "National Geographic"
biography: "Experience the world through the eyes of National Geographic photographers."
external_url: "https://www.natgeo.com"
followers_count: 283000000
follows_count: 145
has_channel: true
highlight_reel_count: 28
is_business_account: true
joined_recently: false
business_category_name: "Media/News Company"
private: false
profile_pic_url: "https://instagram.com/profile_pic.jpg"
profile_pic_url_hd: "https://instagram.com/profile_pic_hd.jpg"
posts_count: 22450
latest_posts: [...]

Example 2: Competitor Monitoring

Input:

user_name: "starbucks"

Output:

id: "8829468"
user_name: "starbucks"
full_name: "Starbucks Coffee"
biography: "Inspiring and nurturing the human spirit - one person, one cup, and one neighborhood at a time."
external_url: "https://www.starbucks.com"
followers_count: 19200000
follows_count: 68
has_channel: false
highlight_reel_count: 12
is_business_account: true
joined_recently: false
business_category_name: "Restaurant"
private: false
profile_pic_url: "https://instagram.com/starbucks_pic.jpg"
profile_pic_url_hd: "https://instagram.com/starbucks_pic_hd.jpg"
posts_count: 5890
latest_posts: [...]

Example 3: Brand Ambassador Discovery

Input:

user_name: "fitness_coach_mike"

Output:

id: "45672891"
user_name: "fitness_coach_mike"
full_name: "Mike Johnson - Fitness Coach"
biography: "Certified Personal Trainer | Nutrition Expert | Helping you reach your fitness goals"
external_url: "https://mikefitnesscoaching.com"
followers_count: 125000
follows_count: 450
has_channel: true
highlight_reel_count: 8
is_business_account: true
joined_recently: false
business_category_name: "Personal Coach"
private: false
profile_pic_url: "https://instagram.com/mike_pic.jpg"
profile_pic_url_hd: "https://instagram.com/mike_pic_hd.jpg"
posts_count: 1247
latest_posts: [...]

Common Use Cases

• Influencer Marketing Research: Gather data on potential influencers including follower counts, engagement metrics, and content style

• Competitor Analysis: Monitor competitor Instagram accounts to track their growth, posting frequency, and content strategy

• Brand Monitoring: Track your own brand's Instagram presence and metrics over time

• Lead Generation: Identify potential business partners or customers based on their Instagram profile information

• Market Research: Analyze industry trends by examining profiles of leading accounts in your sector

• Content Strategy Planning: Study successful accounts to inform your own content approach and posting schedule

• Influencer Verification: Validate influencer claims about follower counts and business status before partnerships

Error Handling

Error Type	Cause	Solution
User Not Found	Instagram username doesn't exist	Verify the username spelling and ensure the account exists
Private Account	User's account is set to private with limited public data	Only public account data can be scraped; request won't fail but latest_posts may be empty
Rate Limit Exceeded	Too many scraping requests in a short time	Implement delays between requests or reduce request frequency
Invalid Username Format	Username contains invalid characters or format	Use valid Instagram username format (letters, numbers, underscores, periods)
Connection Timeout	Unable to reach Instagram servers	Check network connectivity and retry the request
Account Suspended	Instagram account has been suspended or deleted	Verify account status on Instagram directly
Service Unavailable	Instagram's servers are temporarily unavailable	Retry the request after a short delay

Notes

• Public Data Only: This node can only access publicly available information. Private accounts will return basic metadata but no posts.

• Latest Posts: The latest_posts array contains recent post data including URLs, captions, likes, and comments (for public accounts).

• Rate Limiting: Be mindful of request frequency to avoid rate limits. Consider caching results for frequently accessed profiles.

• Data Freshness: Scraped data reflects the profile state at the time of request. For real-time monitoring, schedule periodic scraping.

• Business Accounts: Business and creator accounts provide more detailed information than personal accounts.

• Profile Pictures: Both standard and HD profile picture URLs are provided for downloading or displaying profile images.

• Terms of Service: Ensure your use of scraped Instagram data complies with Instagram's terms of service and applicable laws.

• Data Storage: Consider storing scraped data in a database if you need historical tracking or trend analysis.