instagram-research
Researches Instagram profiles, posts, and Reels via the Crawlora API, returning clean JSON. Use when the user wants a public Instagram profile's stats, a specific post's media/engagement, or a user's Reels feed — instead of scraping the app.
Rank
62
Safety
84
Downloads
1.1k
Updated
Oct 11, 2026
Version
1.0.18
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 11, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 11, 2026
- Adoption signal
- 1.1K downloadsadoption · observed Oct 11, 2026
- Latest release
- 1.0.18release · observed Oct 6, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s17d53nb8nd03gyyfdy32rgde58e574f:instagram-research- Install using `clawhub skill install s17d53nb8nd03gyyfdy32rgde58e574f:instagram-research` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/crawlora-org/instagram-research before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-crawlora-org-instagram-research/snapshot"
Documentation
CLAWHUB
80,065 characters of source documentation, loaded on request.
Extracted files
4 files captured from the source.
SKILL.md
---
name: instagram-research
description: Researches Instagram profiles, posts, and Reels via the Crawlora API, returning clean JSON. Use when the user wants a public Instagram profile's stats, a specific post's media/engagement, or a user's Reels feed — instead of scraping the app.
---
# Instagram research
Look up public Instagram profiles, posts, and Reels — all as normalized JSON
from the Crawlora API, no app scraping or unofficial client libraries.
## When to use this skill
- "What's <username>'s Instagram profile / follower count?"
- "Pull the details for this Instagram post."
- "Get <username>'s recent Reels."
- Competitor social audits, influencer vetting, or brand-mention monitoring
scoped to Instagram.
## Setup (one-time)
- Get a free Crawlora API key (2,000 credits/mo, no card) at [https://crawlora.net](https://crawlora.net?utm_source=github&utm_medium=referral&utm_campaign=crawlora-skills).
- Set `CRAWLORA_API_KEY` in the environment before running the helper.
- The helper reads `CRAWLORA_API_KEY` from the environment and sends requests to `https://api.crawlora.net/api/v1`. Missing/invalid key → `401`.
## How it works
1. **Profile** — `/instagram/profile/{username}` returns public profile
details for a given Instagram username.
2. **Reels** — `/instagram/reels/{id}` returns a feed of Reels for an
Instagram user ID, paginated via the optional `max_id` cursor.
3. **Post detail** — `/instagram/post/{id}/{post_id}` returns the media
details of a specific post, keyed by Instagram user ID and post ID.
Full endpoint list, methods, and params: [`reference/endpoints.md`](reference/endpoints.md).
## Calling the API
```sh
# Profile:
scripts/crawlora.sh /instagram/profile/nasa | jq '.'
# Reels feed (paginate with max_id from the previous response):
scripts/crawlora.sh /instagram/reels/528817151 | jq '.'
scripts/crawlora.sh /instagram/reels/528817151 max_id=<cursor> | jq '.'
# Post detail (requires both the user ID and the post ID):
scripts/crawlora.sh /instagram/post/528817151/3123456789012345678 | jq '.'
```
Use `scripts/crawlora.sh` for all requests; it keeps the API key out of command-line arguments.
## Endpoint reference
See [`reference/endpoints.md`](reference/endpoints.md) for every Instagram
endpoint this skill uses.
## Examples
- **Influencer vetting:** profile + Reels feed to check follower count,
posting cadence, and content mix before a partnership.
- **Competitor social audit:** pull a competitor's profile stats and recent
Reels to gauge follower growth and content strategy over time.
- **Post-level engagement check:** given a known post URL, extract the user
ID and post ID, then call `/instagram/post/{id}/{post_id}` for that post's
media details.
## Notes & limits
- **Credits / pay-on-success:** billed only on `2xx`; free tier 2,000 credits/mo.
Key at [https://crawlora.net](https://crawlora.net?utm_source=github&utm_medium=referral&utm_campaign=crawlora-skills).
- **Public data only** — public_meta.json
{
"ownerId": "kn70shhkf6qpfwgfrbgtep2wkd8c6b4t",
"slug": "instagram-research",
"version": "1.0.18",
"publishedAt": 1791251604688
}reference/endpoints.md
# instagram-research — endpoint reference
> Generated from `scripts/tools.json` by `scripts/generate.mjs` — do not edit by hand.
Endpoints this skill uses, grouped by platform. Call them via `scripts/crawlora.sh` (see SKILL.md).
All paths are relative to the API base `https://api.crawlora.net/api/v1` and require the header `x-api-key: $CRAWLORA_API_KEY`. Path params like `{id}` are substituted into the URL; `GET` params go in the query string; `POST` params go in a JSON body.
**3 endpoints across 1 platform group(s).**
## Instagram (3)
### `instagram_post`
- **HTTP:** `GET /instagram/post/{id}/{post_id}`
- **What:** Retrieve a specific Instagram post by URL shortcode. Returns media details for an Instagram URL shortcode. Use media.code from the reels response or shortcode from a public post URL; numeric media IDs are rejected.
- **Params:** `id` (string, **required**) — Instagram user ID retained for route compatibility; ownership is not verified; `post_id` (string, **required**) — Instagram URL shortcode (media.code), not a numeric media ID
### `instagram_profile`
- **HTTP:** `GET /instagram/profile/{username}`
- **What:** Retrieve an Instagram user profile by username. Returns public profile details for a specified Instagram username.
- **Params:** `username` (string, **required**) — Instagram username
### `instagram_reels`
- **HTTP:** `GET /instagram/reels/{id}`
- **What:** Retrieve Instagram Reels for a user. Returns up to 12 public Reels via anonymous proxied HTTP for the numeric Instagram user ID. Supports opaque `max_id` pagination. Captions, timestamps and original image dimensions are omitted when the public source does not expose them.
- **Params:** `id` (string, **required**) — Numeric Instagram user ID (not a username); `max_id` (string, optional) — Pagination cursor for fetching the next page of Reelsskill-card.md
## Description: Looks up public Instagram profiles, posts, and Reels through the Crawlora API and returns structured JSON. This skill is ready for commercial/non-commercial use. ## Publisher: [crawlora-org](https://clawhub.ai/user/crawlora-org) ### License/Terms of Use: MIT-0 ## Use Case: Developers, analysts, and marketers use this skill to research public Instagram profiles, individual posts, and Reels for social audits or influencer vetting. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: Public lookup identifiers and request data are sent to the third-party Crawlora service. Mitigation: Use only for public lookups and avoid sensitive or private identifiers in routes and queries. Risk: The Crawlora API key is a credential needed for requests. Mitigation: Keep CRAWLORA_API_KEY private; do not hardcode, expose, or commit it. Risk: Use of Instagram public data may be subject to service terms. Mitigation: Review Crawlora's and Instagram's terms before use. ## Reference(s): - [Instagram endpoint reference](artifact/reference/endpoints.md) - [Instagram Research release](https://clawhub.ai/crawlora-org/skills/instagram-research) ## Skill Output: **Output Type(s):** [JSON, Text, Shell commands] **Output Format:** [JSON or text with shell examples] **Output Parameters:** [1D] **Other Properties Related to Output:** [Public profile, post, and Reels data; Reels pagination uses a cursor.] ## Skill Version(s): 1.0.18 (source: server-resolved release metadata) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/crawlora-org/skills/instagram-research",
"sourceUrl": "https://clawhub.ai/crawlora-org/skills/instagram-research",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T12:13:43.272Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-crawlora-org-instagram-research/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-crawlora-org-instagram-research/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-11T12:13:43.272Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.1K downloads",
"href": "https://clawhub.ai/crawlora-org/instagram-research",
"sourceUrl": "https://clawhub.ai/crawlora-org/instagram-research",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T12:13:43.272Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.0.18",
"href": "https://clawhub.ai/crawlora-org/instagram-research",
"sourceUrl": "https://clawhub.ai/crawlora-org/instagram-research",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-10-06T01:53:24.688Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-crawlora-org-instagram-research/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-crawlora-org-instagram-research/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.0.18",
"description": "Sync skill instructions, references, and helper from GitHub a91c30113b1827d719267576bbd2936c99a28029",
"href": "https://clawhub.ai/crawlora-org/instagram-research",
"sourceUrl": "https://clawhub.ai/crawlora-org/instagram-research",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-10-06T01:53:24.688Z",
"isPublic": true
}
]
}Record generated Oct 11, 2026.
