instagram

Fetch and publish Instagram media via the Graph API using curl.

76|18|Updated Dec 12, 2025
One-click install
npx skills add https://github.com/vm0-ai/vm0-skills --skill instagram
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: instagram
Source: https://github.com/vm0-ai/vm0-skills/tree/main/instagram
Command: npx skills add https://github.com/vm0-ai/vm0-skills --skill instagram

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables reading and publishing Instagram content using the Graph API, automating social media workflows.

Core Features & Use Cases

  • Fetch recent media (photos/videos/Reels)
  • Get media details and publish image posts
  • Hashtag search and content insights

Quick Start

Fetch recent media: bash -c 'curl -s -X GET "https://graph.facebook.com/v21.0/${INSTAGRAM_BUSINESS_ACCOUNT_ID}/media?fields=id,caption,media_type,media_url" --header "Authorization: Bearer ${INSTAGRAM_ACCESS_TOKEN}"' | jq .

Frequently Asked Questions about instagram

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fetch recent Instagram media using the Graph API?

Fetch recent Instagram media by calling the Graph API endpoint /{account_id}/media with your access token and business account ID via curl. The API returns media IDs, captions, types, and URLs for photos, videos, and Reels from your Instagram Business or Creator account.

What permissions do I need to publish posts to Instagram via the Graph API?

Publishing to Instagram requires three permissions: instagram_basic for reading access, instagram_content_publish to create posts, and instagram_manage_insights to retrieve performance data. These must be granted to your access token before calling the /media_publish endpoint.

Can I search for hashtags on Instagram using the Graph API?

Yes, the Graph API's /ig_hashtag_search endpoint lets you search for hashtags by name and retrieve their IDs. Use this to target specific hashtags when publishing content or analyzing hashtag-based engagement on your Business account.

How do I set up curl to publish image posts to Instagram?

Set INSTAGRAM_ACCESS_TOKEN and INSTAGRAM_BUSINESS_ACCOUNT_ID as environment variables, then use curl with the /media_publish endpoint and your image URL. The API validates permissions and account type before creating the post.

What account types work with Instagram Graph API publishing?

Instagram Business and Creator accounts support Graph API publishing. Personal accounts do not have access to the /media_publish endpoint or advanced permissions like instagram_content_publish and instagram_manage_insights.