apidojo-io/social-media-skills1 file

Instagram Scraper

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.

Specification
Skill ID
apidojo-io/social-media-skills/instagram-scraper
Publisher
apidojo-io
Repository
social-media-skills
Installs
589
Files
1
Synced
Oct 7, 2026
How to use it

Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.

apidojo-io/social-media-skills/instagram-scraperInstalls these files
  • SKILL.md

What this skill tells the agent

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

ActorPurposeActor ID
Instagram ScraperAll-in-one: posts, reels, profiles, hashtags, locations, audio, tagged postsVLKR1emKm1YGLmiuZ
Instagram Hashtag ScraperPosts and reels by hashtag or keywordZSBuGcAOcTZjHUVyv
Instagram Location ScraperGeo-tagged posts from Instagram place URLs or location IDs6cMzJhRlD4wfzrWXg
Instagram Comments ScraperComments and replies from post URLs6lDMfTxEj4h8hSZ6i
Instagram User ScraperProfiles, followers, following lists, public emailslezdhAFfa4H5zAb2A

Setup

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

  1. Sign up / log in at apify.com/?fpr=yhdrb
  2. Subscribe to a paid plan at apify.com/pricing?fpr=yhdrb — without this, API calls will be rejected.
  3. 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",

Use this skill in a project

Open any RiverX project, search the Skills panel for apidojo-io/social-media-skills/instagram-scraper, and install it in one click.

Use this skill