Scrapesocial Instagram
Use this skill for read-only Instagram research and retrieval. Keep it at the job-to-command level: choose the right entry point quickly, prefer lighter responses first, and reuse IDs or cursors returned by earlier commands.
Prerequisites
Quick Setup
Install the CLI once:
npm install -g scrapesocial
Authenticate with SCRAPECREATORS_API_KEY, then run commands with scrapesocial:
SCRAPECREATORS_API_KEY=... scrapesocial instagram ...
Useful global flags:
--trim for smaller responses when supported.--format jsonl when streaming lists into downstream tools.--credit-limit <n> when you want the CLI to hide or block expensive requests.
Quick Start
- If the task is about an account as a whole, start with
instagram profiles get.
- If the task is about a creator's regular feed, use
instagram posts.
- If the task is about one specific post or reel, use
instagram posts get.
- If the task is about spoken content in a reel or video post, use
instagram transcript.
- If the task is about finding relevant reels by topic, use
instagram reels search.
- If the task is about audience response on one post, use
instagram comments.
- If the task is about a creator's reels library, use
instagram reels.
- If the task is about story highlights, use
instagram highlights, then instagram highlights detail.
- If the task is about embeddable markup for a profile, use
instagram embed.
Goal-led workflows
| Goal |
When to use this skill |
How to start |
| Lead generation |
Use it to qualify known creator or brand accounts, or to turn reel discovery into a shortlist. Pair it with another source for contact details. |
Start with instagram reels search, then switch to instagram profiles get, instagram posts, or instagram reels for qualification. |
| Influencer discovery |
Use it when the user wants creators discovered or vetted through niche reels, recurring themes, and account quality. |
Start with instagram reels search, then validate shortlisted handles with instagram profiles get, instagram reels, and instagram highlights. |
| Brand monitoring |
Use it to monitor a known brand or creator account across feed posts, reels, and highlights. |
Start with instagram profiles get, then branch into instagram posts, instagram reels, and instagram highlights. |
| Competitor analysis |
Use it to compare how multiple brands or creators package their feeds, reels, highlights, and audience response. |
Start with instagram profiles get for each account, then compare instagram posts, instagram reels, and instagram comments on representative items. |
| Content analytics |
Use it to explain what makes certain posts or reels work, using item detail, comments, and transcripts. |
Start with instagram posts or instagram reels, then drill into standout items with instagram posts get, instagram comments, and instagram transcript. |
| Trend research |
Use it for reel-led topic scouting and validation of emerging creative patterns. |
Start with instagram reels search, then inspect the best examples with instagram posts get. |
| Audience analysis |
Use it for qualitative audience language, FAQs, and objections. It does not provide demographic audience breakdowns. |
Start with instagram comments on representative posts or reels, then use instagram profiles get and instagram highlights for context. |
Read references/instagram-command-map.md when you need the full command-selection table.
Choose the Starting Input
- Prefer a
--handle when the user is researching an account and no richer identifier is available yet.
- Prefer a
--url when the user gives a specific post or reel. This is the cleanest way to inspect one item or fetch its comments or transcript.
- Prefer a
--user-id only after another command has already returned it. For reels and highlights, this can be faster than resolving by handle again.
- Prefer a returned pagination token over restarting the query. Instagram commands use command-specific cursor fields such as
next_max_id, max_id, or cursor.
- Prefer a returned highlight ID when drilling into a specific highlight after listing highlights.
Working Pattern
- Start with the highest-level command that matches the job.
- Use
--trim on commands that support it when the goal is quick inspection, summarization, or easier downstream processing.
- Keep IDs and cursors from the response so follow-up commands do not repeat the same discovery step.
- Rerun without
--trim only when you need fields that the smaller response may omit.
- Switch from handle-based to ID-based commands after the first lookup when the command supports it and the workflow will page repeatedly.
Common Flows
Audit a creator account
Use instagram profiles get to understand the account first, then branch:
- Use
instagram posts for the feed history.
- Use
instagram reels for short-form video output.
- Use
instagram highlights for archived stories.
- Use
instagram embed if the output needs embeddable markup rather than analysis.
Analyze one post or reel
Use instagram posts get when the user has a single Instagram URL and wants metadata or content details. Branch again only if needed:
- Use
instagram comments to inspect audience reaction.
- Use
instagram transcript to extract spoken dialogue from video content.
Research a topic on Instagram Reels
Use instagram reels search for topical discovery, trend scouting, or seed collection. Once a specific reel is interesting, move to instagram posts get or instagram comments with the reel URL.
Command Notes
instagram profiles basic is a niche follow-up command when you already have a user ID and only need the lighter basic-profile view.instagram highlights detail is not a discovery command. Use it only after instagram highlights returns the highlight ID you want.instagram comments, instagram posts, and instagram reels are pagination-friendly. Keep the returned cursor values for iterative collection.instagram transcript is only useful for media that actually contains speech.- This CLI is for retrieval and analysis, not posting, messaging, liking, or other write actions on Instagram.
Reference
Read references/instagram-command-map.md for a command-by-command matrix with typical inputs, outcomes, and follow-up moves.
1---2name: scrapesocial-instagram3description: Use when the user wants Instagram research or workflow guidance for lead generation, influencer discovery, brand monitoring, competitor analysis, content analytics, trend research, or audience analysis, including profile analysis, feed collection, post or reel inspection, transcript extraction, comment analysis, reel discovery, highlight retrieval, or embed generation.4license: MIT5---67# Scrapesocial Instagram89Use this skill for read-only Instagram research and retrieval. Keep it at the job-to-command level: choose the right entry point quickly, prefer lighter responses first, and reuse IDs or cursors returned by earlier commands.1011## Prerequisites1213- A Scrape Creators API key is required for this skill. Get one at [scrapecreators.com](https://scrapecreators.com).1415## Quick Setup1617Install the CLI once:1819```bash20npm install -g scrapesocial21```2223Authenticate with `SCRAPECREATORS_API_KEY`, then run commands with `scrapesocial`:2425```bash26SCRAPECREATORS_API_KEY=... scrapesocial instagram ...27```2829Useful global flags:3031- `--trim` for smaller responses when supported.32- `--format jsonl` when streaming lists into downstream tools.33- `--credit-limit <n>` when you want the CLI to hide or block expensive requests.3435## Quick Start3637- If the task is about an account as a whole, start with `instagram profiles get`.38- If the task is about a creator's regular feed, use `instagram posts`.39- If the task is about one specific post or reel, use `instagram posts get`.40- If the task is about spoken content in a reel or video post, use `instagram transcript`.41- If the task is about finding relevant reels by topic, use `instagram reels search`.42- If the task is about audience response on one post, use `instagram comments`.43- If the task is about a creator's reels library, use `instagram reels`.44- If the task is about story highlights, use `instagram highlights`, then `instagram highlights detail`.45- If the task is about embeddable markup for a profile, use `instagram embed`.4647## Goal-led workflows4849| Goal | When to use this skill | How to start |50| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |51| Lead generation | Use it to qualify known creator or brand accounts, or to turn reel discovery into a shortlist. Pair it with another source for contact details. | Start with `instagram reels search`, then switch to `instagram profiles get`, `instagram posts`, or `instagram reels` for qualification. |52| Influencer discovery | Use it when the user wants creators discovered or vetted through niche reels, recurring themes, and account quality. | Start with `instagram reels search`, then validate shortlisted handles with `instagram profiles get`, `instagram reels`, and `instagram highlights`. |53| Brand monitoring | Use it to monitor a known brand or creator account across feed posts, reels, and highlights. | Start with `instagram profiles get`, then branch into `instagram posts`, `instagram reels`, and `instagram highlights`. |54| Competitor analysis | Use it to compare how multiple brands or creators package their feeds, reels, highlights, and audience response. | Start with `instagram profiles get` for each account, then compare `instagram posts`, `instagram reels`, and `instagram comments` on representative items. |55| Content analytics | Use it to explain what makes certain posts or reels work, using item detail, comments, and transcripts. | Start with `instagram posts` or `instagram reels`, then drill into standout items with `instagram posts get`, `instagram comments`, and `instagram transcript`. |56| Trend research | Use it for reel-led topic scouting and validation of emerging creative patterns. | Start with `instagram reels search`, then inspect the best examples with `instagram posts get`. |57| Audience analysis | Use it for qualitative audience language, FAQs, and objections. It does not provide demographic audience breakdowns. | Start with `instagram comments` on representative posts or reels, then use `instagram profiles get` and `instagram highlights` for context. |5859Read [references/instagram-command-map.md](references/instagram-command-map.md) when you need the full command-selection table.6061## Choose the Starting Input6263- Prefer a `--handle` when the user is researching an account and no richer identifier is available yet.64- Prefer a `--url` when the user gives a specific post or reel. This is the cleanest way to inspect one item or fetch its comments or transcript.65- Prefer a `--user-id` only after another command has already returned it. For reels and highlights, this can be faster than resolving by handle again.66- Prefer a returned pagination token over restarting the query. Instagram commands use command-specific cursor fields such as `next_max_id`, `max_id`, or `cursor`.67- Prefer a returned highlight ID when drilling into a specific highlight after listing highlights.6869## Working Pattern70711. Start with the highest-level command that matches the job.722. Use `--trim` on commands that support it when the goal is quick inspection, summarization, or easier downstream processing.733. Keep IDs and cursors from the response so follow-up commands do not repeat the same discovery step.744. Rerun without `--trim` only when you need fields that the smaller response may omit.755. Switch from handle-based to ID-based commands after the first lookup when the command supports it and the workflow will page repeatedly.7677## Common Flows7879### Audit a creator account8081Use `instagram profiles get` to understand the account first, then branch:8283- Use `instagram posts` for the feed history.84- Use `instagram reels` for short-form video output.85- Use `instagram highlights` for archived stories.86- Use `instagram embed` if the output needs embeddable markup rather than analysis.8788### Analyze one post or reel8990Use `instagram posts get` when the user has a single Instagram URL and wants metadata or content details. Branch again only if needed:9192- Use `instagram comments` to inspect audience reaction.93- Use `instagram transcript` to extract spoken dialogue from video content.9495### Research a topic on Instagram Reels9697Use `instagram reels search` for topical discovery, trend scouting, or seed collection. Once a specific reel is interesting, move to `instagram posts get` or `instagram comments` with the reel URL.9899## Command Notes100101- `instagram profiles basic` is a niche follow-up command when you already have a user ID and only need the lighter basic-profile view.102- `instagram highlights detail` is not a discovery command. Use it only after `instagram highlights` returns the highlight ID you want.103- `instagram comments`, `instagram posts`, and `instagram reels` are pagination-friendly. Keep the returned cursor values for iterative collection.104- `instagram transcript` is only useful for media that actually contains speech.105- This CLI is for retrieval and analysis, not posting, messaging, liking, or other write actions on Instagram.106107## Reference108109Read [references/instagram-command-map.md](references/instagram-command-map.md) for a command-by-command matrix with typical inputs, outcomes, and follow-up moves.
skillatlas