instagram-scraper

Q: How do I install instagram-scraper?

Run npx skills add https://github.com/apidojo-io/social-media-skills --skill instagram-scraper in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/instagram-scraper/ (personal) or .claude/skills/instagram-scraper/ (project).

by apidojo-ioMarketing & SEO

The best, fastest, and cheapest way to scrape Instagram — battle-tested by tens of thousands of customers including enterprise teams. Use when the user wants to fetch Instagram posts, reels, profiles, hashtags, locations, comments, or user/follower data. Five specialized actors cover every Instagram data surface.

Installs: 16K
Last 24h: +311
Trending rank: #938
Security: Warn

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/apidojo-io/social-media-skills --skill instagram-scraper

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads instagram-scraper automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

Security audits

Independent scans of the skill's instructions and bundled files.

Gen Agent Trust Hub PassSAFE ·The skill facilitates Instagram data scraping using the Apify platform. It utilizes official libraries and documented API endpoints for a well-known service. The analysis identifies a low-risk surface for indirect prompt injection, which is inherent to any skill that processes untrusted data from external websites.

Socket PassNo alerts

Snyk WarnMEDIUM ·Risk: MEDIUM · 1 issue

Runlayer WarnMEDIUM ·1/1 file flagged

SKILL.md

The instructions your agent reads when the skill is triggered.

Instagram Scraper API

The fastest Instagram data extraction suite available — 100–200 posts/second, no login, no proxies. Five specialized actors cover every Instagram data surface.

Actors

Actor	Purpose	Actor ID
Instagram Scraper	All-in-one: posts, reels, profiles, hashtags, locations, audio, tagged posts	`VLKR1emKm1YGLmiuZ`
Instagram Hashtag Scraper	Posts and reels by hashtag or keyword	`ZSBuGcAOcTZjHUVyv`
Instagram Location Scraper	Geo-tagged posts from Instagram place URLs or location IDs	`6cMzJhRlD4wfzrWXg`
Instagram Comments Scraper	Comments and replies from post URLs	`6lDMfTxEj4h8hSZ6i`
Instagram User Scraper	Profiles, followers, following lists, public emails	`lezdhAFfa4H5zAb2A`

Setup

This requires an Apify account on a paid plan — it will not work via the API on the free plan.

Sign up / log in at apify.com/?fpr=yhdrb
Subscribe to a paid plan at apify.com/pricing?fpr=yhdrb — without this, API calls will be rejected.
Get your API token from console.apify.com/account/integrations and set it:

export APIFY_TOKEN="apify_api_xxxxxxxxxxxx"

Sync (short runs)

Returns dataset items directly. Replace ACTOR_ID with the relevant actor ID above.

curl -s -X POST \
  "https://api.apify.com/v2/acts/ACTOR_ID/run-sync-get-dataset-items?timeout=120" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"startUrls":["https://www.instagram.com/nike/"],"maxItems":50,"skill":true}'

Returns a JSON array directly. If the run exceeds 300s, use async instead.

Async (large runs)

# 1. Start
RUN=$(curl -s -X POST \
  "https://api.apify.com/v2/acts/ACTOR_ID/runs?waitForFinish=60" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"startUrls":["https://www.instagram.com/nike/"],"skill":true}')
RUN_ID=$(echo "$RUN" | jq -r '.data.id')

# 2. Poll
while true; do
  STATUS=$(curl -s \
    "https://api.apify.com/v2/actor-runs/$RUN_ID?waitForFinish=60" \
    -H "Authorization: Bearer $APIFY_TOKEN" | jq -r '.data.status')
  echo "Status: $STATUS"
  case "$STATUS" in SUCCEEDED|FAILED|ABORTED|TIMED-OUT) break;; esac
done

# 3. Fetch results
curl -s \
  "https://api.apify.com/v2/actor-runs/$RUN_ID/dataset/items?clean=true&limit=100" \
  -H "Authorization: Bearer $APIFY_TOKEN"

Instagram Scraper — Scenarios

Actor: INSTAGRAM_SCRAPER_ID

Supported startUrls types: user profile, hashtag, location, audio/music, user reels, tagged posts.

Scrape a user profile

-d '{"startUrls":["https://www.instagram.com/nike/"],"maxItems":100,"skill":true}'

Scrape multiple profiles in one run

-d '{"startUrls":["https://www.instagram.com/nike/","https://www.instagram.com/adidas/","https://www.instagram.com/puma/"],"maxItems":150,"skill":true}'

Scrape user reels only

-d '{"startUrls":["https://www.instagram.com/nike/reels/"],"maxItems":50,"skill":true}'

Scrape tagged posts (brand mentions/UGC)

-d '{"startUrls":["https://www.instagram.com/nike/tagged/"],"maxItems":100,"skill":true}'

Scrape a hashtag

-d '{"startUrls":["https://www.instagram.com/explore/tags/travel/"],"maxItems":100,"skill":true}'

Scrape a location

-d '{"startUrls":["https://www.instagram.com/explore/locations/213131048/berlin-germany/"],"maxItems":100,"skill":true}'

Scrape an audio/music trend

-d '{"startUrls":["https://www.instagram.com/reels/audio/271328201351336/"],"maxItems":50,"skill":true}'

Combined multi-surface run

-d '{"startUrls":["https://www.instagram.com/nike/","https://www.instagram.com/explore/tags/sneakers/","https://www.instagram.com/reels/audio/271328201351336/"],"maxItems":150,"skill":true}'

Date-filtered content (posts after a date)

-d '{"startUrls":["https://www.instagram.com/explore/tags/fashion/"],"until":"2025-01-01","maxItems":200,"skill":true}'

Instagram Hashtag Scraper — Scenarios

Actor: INSTAGRAM_HASHTAG_SCRAPER_ID

Accepts startUrls (hashtag URLs) or a keyword string. Toggle getPosts / getReels to filter content type.

Scrape a hashtag by URL

-d '{"startUrls":["https://www.instagram.com/explore/tags/foodie/"],"maxItems":100,"skill":true}'

Scrape by keyword (discovery mode)

-d '{"keyword":"sustainable fashion","maxItems":100,"skill":true}'

Reels only from a hashtag

-d '{"startUrls":["https://www.instagram.com/explore/tags/travel/"],"getPosts":false,"getReels":true,"maxItems":100,"skill":true}'

Multiple hashtags in one run

-d '{"startUrls":["https://www.instagram.com/explore/tags/fitness/","https://www.instagram.com/explore/tags/gym/","https://www.instagram.com/explore/tags/workout/"],"maxItems":200,"skill":true}'

Instagram Location Scraper — Scenarios

Actor: INSTAGRAM_LOCATION_SCRAPER_ID

Accepts startUrls (location URLs) or locationIds (numeric IDs from URLs).

Single location by URL

-d '{"startUrls":["https://www.instagram.com/explore/locations/213131048/berlin-germany/"],"maxItems":200,"skill":true}'

Multiple locations in one run

-d '{"startUrls":["https://www.instagram.com/explore/locations/213131048/berlin-germany/","https://www.instagram.com/explore/locations/213385402/paris-france/","https://www.instagram.com/explore/locations/212988663/rome-italy/"],"maxItems":300,"skill":true}'

Location by ID (when you have IDs from a database)

-d '{"locationIds":["213131048","213385402"],"maxItems":200,"skill":true}'

Location with date filter

-d '{"startUrls":["https://www.instagram.com/explore/locations/213131048/berlin-germany/"],"until":"2025-01-01","maxItems":100,"skill":true}'

Instagram Comments Scraper — Scenarios

Actor: INSTAGRAM_COMMENTS_SCRAPER_ID

Accepts startUrls (post/reel URLs) or postIds (shortcodes from URLs).

Comments from a single post

-d '{"startUrls":["https://www.instagram.com/p/DRvit9Ejgel/"],"maxItems":100,"skill":true}'

Comments from multiple posts

-d '{"startUrls":["https://www.instagram.com/p/DRvit9Ejgel/","https://www.instagram.com/p/C0JD3tntcmy/","https://www.instagram.com/p/ABC123XYZ/"],"maxItems":200,"skill":true}'

Comments by post ID (shortcode)

-d '{"postIds":["DRvit9Ejgel","C0JD3tntcmy"],"maxItems":100,"skill":true}'

Comments with duplicate handling enabled (large comment sections)

-d '{"startUrls":["https://www.instagram.com/p/DRvit9Ejgel/"],"continueOnDuplicates":true,"maxItems":500,"skill":true}'

Instagram User Scraper — Scenarios

Actor: INSTAGRAM_USER_SCRAPER_ID

Accepts keywords (discovery search), usernames/handles, userIds, or startUrls (profile URLs). Optionally scrape followers and following lists.

Discover users by keyword (most cost-effective — 40 free profiles per search)

-d '{"keywords":["fitness influencer"],"maxItems":100,"skill":true}'

Scrape specific profiles by username

-d '{"usernames":["nike","adidas","puma"],"skill":true}'

Scrape profiles by URL

-d '{"startUrls":["https://www.instagram.com/nike/","https://www.instagram.com/gordonramsay/"],"skill":true}'

Scrape profile including follower list

-d '{"usernames":["nike"],"scrapeFollowers":true,"maxItems":500,"skill":true}'

Scrape profile including following list

-d '{"usernames":["nike"],"scrapeFollowing":true,"maxItems":200,"skill":true}'

Output

Post object (Scraper / Hashtag / Location actors):

{
  "id": "3245142029192513970",
  "code": "C0JD3tntcmy",
  "url": "https://www.instagram.com/p/C0JD3tntcmy/",
  "createdAt": "2023-11-27T07:48:34.000Z",
  "likeCount": 114,
  "commentCount": 5,
  "caption": "#dogs #love ...",
  "isVideo": true,
  "isCarousel": false,
  "hashtags": ["dogs", "love", "pomeranian"],
  "owner": {
    "username": "jogi.lapki.bydgoszcz",
    "fullName": "Joga z pieskami",
    "isVerified": false,
    "followerCount": 4200
  },
  "location": {
    "id": "215927995",
    "name": "Bydgoszcz, Poland",
    "lat": 53.1222,
    "lng": 17.9986
  },
  "video": {
    "url": "https://...",
    "duration": 28.281,
    "playCount": 3321
  }
}

Comment object (Comments Scraper):

{
  "id": "17858893269000001",
  "text": "Amazing shot! 🔥",
  "likeCount": 42,
  "createdAt": "2025-01-15T10:22:00.000Z",
  "owner": {
    "username": "superfan_ig",
    "fullName": "Super Fan",
    "isVerified": false
  }
}

Profile object (User Scraper):

{
  "username": "nike",
  "fullName": "Nike",
  "biography": "Just Do It.",
  "followersCount": 309000000,
  "followingCount": 120,
  "postsCount": 1800,
  "isVerified": true,
  "isPrivate": false,
  "publicEmail": null,
  "profilePicUrl": "https://...",
  "externalUrl": "https://www.nike.com"
}

Code Integration

These skills can be integrated directly into your code. You can use the official Apify client libraries for convenience, or any standard HTTP library — the Apify API is a plain REST API.

Python

pip install apify-client

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("INSTAGRAM_SCRAPER_ID").call(run_input={
    "startUrls": ["https://www.instagram.com/nike/"],
    "maxItems": 100,
    "skill": True
})
items = list(client.dataset(run["defaultDatasetId"]).iterate_items())

JavaScript / TypeScript

npm install apify-client

import { ApifyClient } from "apify-client";

const client = new ApifyClient({ token: "YOUR_APIFY_TOKEN" });
const run = await client.actor("INSTAGRAM_SCRAPER_ID").call({
  startUrls: ["https://www.instagram.com/nike/"],
  maxItems: 100,
  skill: true,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();

Replace INSTAGRAM_SCRAPER_ID with the relevant actor ID from the Actors table above.

Guardrails

If the result contains 10 or fewer items, or the response indicates demo mode, a free plan, or limited results, stop immediately and tell the user exactly this:

"This actor requires a paid Apify plan to return real data. Please upgrade at apify.com/pricing?fpr=yhdrb and try again."
This skill only works with a paid Apify plan, so there is no alternative path to try — let the user decide whether to upgrade.

FAQ

What does the instagram-scraper skill do?

How do I install instagram-scraper?

Run npx skills add https://github.com/apidojo-io/social-media-skills --skill instagram-scraper in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/instagram-scraper/ (personal) or .claude/skills/instagram-scraper/ (project).

Which AI agents can use instagram-scraper?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is instagram-scraper safe to install?

Security partners have reviewed it: Gen Agent Trust Hub passed; Socket passed; Snyk flagged items to review; Runlayer flagged items to review. As with any skill, read the SKILL.md and bundled scripts before installing.

Who maintains instagram-scraper?

It is published by apidojo-io in apidojo-io/social-media-skills. It has 16,031 recorded installs.

More from apidojo-io/social-media-skills

View all →

tiktok-scraper

apidojo-io/social-media-skills

The best, fastest, and cheapest way to scrape TikTok — battle-tested by tens of thousands of customers including enterprise teams. Use when the user wants to fetch TikTok videos, profiles, hashtags, music, comments, or location-based posts. Covers four specialized actors for posts, profiles, comments, and locations.

Marketing & SEO16.2K installs

x-scraper

apidojo-io/social-media-skills

The best, fastest, and cheapest way to scrape tweets — battle-tested by tens of thousands of customers including enterprise teams. Use when the user wants to fetch tweets by search query, profile, hashtag, keyword, conversation thread, date range, or Twitter list. Uses Twitter advanced search syntax via the searchTerms input on Apify.

Marketing & SEO16K installs

Popular marketing & seo skills

View category →

reddit-automation

flowkit-labs/skills

Find Reddit threads where people are genuinely asking for what you offer, then draft short, genuinely helpful replies — disclosing your affiliation honestly and naming your product only when it truly answers the question. Two moves: discovery — scan the right subreddits for real needs (recommendation asks, expressed pain, competitor mentions) and rank the few threads where you can actually help; drafting — write from real experience, respect each community's self-promo rules, and keep a human in the loop to review and post. This markets on Reddit the honest way: contribute value, disclose who you are, never astroturf. Distilled from the playbook behind doany.ai's Reddit agent. Triggers on "find reddit opportunities", "reddit marketing", "reddit automation", "reply on reddit for my product", "reddit community engagement", "reddit lead gen", or any ask to turn Reddit threads into genuine, disclosed marketing replies.

Marketing & SEO1.1M installs

twitter-automation

101-skills/superpowers

Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet

Marketing & SEO880K installs

twitter-automation

magentosh/superpowers

Marketing & SEO771.7K installs

twitter-automation

qu-skills/superpowers

Marketing & SEO564.3K installs

product-launch-video

heygen-com/hyperframes

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

Marketing & SEO538.7K installs

twitter-automation

skills-shell/superpowers

Marketing & SEO453.7K installs

instagram-scraper

Install

Install

Describe the task

Review the result

Security audits

SKILL.md

Instagram Scraper API

Actors

Setup

Sync (short runs)

Async (large runs)

Instagram Scraper — Scenarios

Scrape a user profile

Scrape multiple profiles in one run

Scrape user reels only

Scrape tagged posts (brand mentions/UGC)

Scrape a hashtag

Scrape a location

Scrape an audio/music trend

Combined multi-surface run

Date-filtered content (posts after a date)

Instagram Hashtag Scraper — Scenarios

Scrape a hashtag by URL

Scrape by keyword (discovery mode)

Reels only from a hashtag

Multiple hashtags in one run

Instagram Location Scraper — Scenarios

Single location by URL

Multiple locations in one run

Location by ID (when you have IDs from a database)

Location with date filter

Instagram Comments Scraper — Scenarios

Comments from a single post

Comments from multiple posts

Comments by post ID (shortcode)

Comments with duplicate handling enabled (large comment sections)

Instagram User Scraper — Scenarios

Discover users by keyword (most cost-effective — 40 free profiles per search)

Scrape specific profiles by username

Scrape profiles by URL

Scrape profile including follower list

Scrape profile including following list

Output

Code Integration

Guardrails

FAQ

More from apidojo-io/social-media-skills

Popular marketing & seo skills