Instagram followers Scraper — Apify Actor 📸✨

Extract trimmed Instagram profile metadata from profile-info . This Apify Actor posts each profile URL to the API and returns only the requested fields so your dataset stays clean and compact.

---

Output — fields returned 🔎

Each dataset item contains only these keys (best-effort extraction from the API response):

• profile_url — the input profile URL you requested.
• status — "ok", "failed", or raw status value from the API (best-effort).
• follower_count — integer or best-effort value.
• following_count — integer or best-effort value.
• full_name — profile display name.
• page_id — numeric/string profile id.
• page_name — username / handle.
• number_of_members — subscribers / members (best-effort).
• bio_links — list of links (normalized from various API shapes).

Input (actor input JSON) ⚙️

Provide input JSON when running the actor. Important fields:

Field	Type	Required	Default	Description
startUrls	array<{url:string}> | string[]	✅	—	One or more Instagram profile URLs. Each item can be a dict { "url": "..." } or a plain string.
proxyConfiguration	object	❌	{ "useApifyProxy": false }	Apify proxy settings. Example: { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US" }
concurrency	integer	❌	5	Number of concurrent HTTP requests (default 5).

Example input

{
  "startUrls": [
    { "url": "https://www.instagram.com/cristiano/" },
    { "url": "https://www.instagram.com/mrbean/" }
  ],
  "proxyConfiguration": {
    "useApifyProxy": false
  },
  
}

---

Example output 📦

[
  {
    "profile_url": "https://www.instagram.com/cristiano/",
    "status": "success",
    "follower_count": 665250679,
    "following_count": 614,
    "full_name": "Cristiano Ronaldo",
    "page_id": "173560420",
    "page_name": "Cristiano Ronaldo",
    "number_of_members": 11769643,
    "bio_links": [
      "http://avacr7.com/en"
    ]
  },
  {
    "profile_url": "https://www.instagram.com/mrbean/",
    "status": "success",
    "follower_count": 9773514,
    "following_count": 41,
    "full_name": "Mr Bean",
    "page_id": "4126839805",
    "page_name": "Mr Bean",
    "number_of_members": null,
    "bio_links": [
      "https://mr-bean-shop.fourthwall.com/en-gbp/"
    ]
  }
]

---

Implementation notes & tips 🛠️

• The Actor uses httpx.AsyncClient to POST multipart/form-data to the external API endpoint.
• Proxy configuration uses Actor.create_proxy_configuration(...) and .new_url() when proxyConfiguration.useApifyProxy is true.
• Field extraction is robust: it searches multiple likely key names and nested paths. If the API returns a different schema for certain fields, the corresponding output may be null.
• hd_profile_pic_url_info is returned as the original object when available (the actor tries to extract a url key if present). If you prefer always a plain string URL there, say so and it can be normalized.
• invite_link and bio_links preserve lists when found; they may be a single string or a list depending on the API payload.

---

Running locally vs on Apify 🌍

• On Apify: just upload the actor, set the startUrls and proxyConfiguration in the run input, then start. Results appear in Dataset.
• Locally: you can run the script, but Actor SDK calls require Apify environment or mocking — running locally for development is possible with adjustments or by testing the HTTP logic alone.