Instagram website screenshot

Instagram

Instagram is a photo and video sharing social networking platform owned by Meta. The Instagram APIs allow developers to build integrations with Instagram Business and Creator accounts for content publishing, media management, comment moderation, hashtag discovery, insights and analytics, messaging, and embedding. Available through the Meta Developer Platform with Facebook Login or Instagram Login authentication.

Instagram publishes 7 APIs on the APIs.io network, including Comments API, Hashtags API, Insights API, and 4 more. Tagged areas include Instagram, Meta, Photos, Social Media, and Videos.

The Instagram catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

Instagram’s developer surface includes authentication, developer portal, getting-started guide, changelog, support, engineering blog, and 10 more developer resources.

58.0/100 strong ▬ flat Agent 37/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessPaidSelf serve
9 APIs 12 Features 8 Use Cases
InstagramMetaPhotosSocial MediaVideosContent Publishing

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 58.0/100 · strong
Contract Quality 16.5 / 25
Developer Ergonomics 8.3 / 20
Commercial Clarity 10.0 / 20
Operational Transparency 8.9 / 13
Governance 7.0 / 12
Discoverability 7.4 / 10
Agent readiness — 37/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/instagram: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 9

Individual APIs this provider publishes, each with its own machine-readable definition.

Instagram Messaging API

The Messenger API support for Instagram consolidates Instagram and Facebook Page messaging into a unified platform. Enables businesses and creators to manage conversations, send...

Instagram oEmbed API

The Instagram oEmbed endpoint returns HTML and metadata for embedding Instagram photos, videos, reels, and carousels on third-party websites using the standard oEmbed protocol.

Instagram Comments API

Comment management and moderation

Instagram Hashtags API

Hashtag search and media discovery

Instagram Insights API

Account and media level analytics

Instagram Media API

Photos, videos, stories, reels, and carousels

Instagram Mentions API

Content where account was mentioned

Instagram Publishing API

Content creation and publishing workflow

Instagram Users API

Instagram Business and Creator account profiles

Scroll for all 9

Postman Collections 7

Ready-to-run Postman collections for exercising this provider's APIs.

Scroll for all 7

Pricing Plans 1

Published pricing tiers and plan structures.

Rate Limits 1

Documented rate limits and quota policies.

Instagram Rate Limits

6 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Features 12

Notable capabilities this provider offers.

Content Publishing

Publish photos, videos, reels, carousels, and stories to Instagram Business and Creator accounts programmatically.

Media Management

Retrieve, manage, and organize published media including photos, videos, stories, and albums.

Comment Moderation

Read, reply to, hide, and delete comments on Instagram media for brand safety and engagement.

Hashtag Discovery

Search for hashtags and discover top and recent media associated with specific hashtags.

Mention Tracking

Identify and retrieve media where your account has been mentioned by other Instagram users.

Insights and Analytics

Access account-level and media-level metrics for reach, impressions, engagement, and audience demographics.

Instagram Direct Messaging

Send and receive messages through Instagram Direct for customer service and business communication.

Stories Publishing

Publish ephemeral story content including photos and videos that disappear after 24 hours.

Reels Publishing

Create and publish short-form video content as Instagram Reels.

oEmbed

Embed Instagram posts, reels, and videos on third-party websites using the standard oEmbed protocol.

Webhooks

Receive real-time notifications for comments, mentions, messages, and story insights via webhooks.

Private Replies

Send private direct messages in response to public comments on your Instagram media.

Scroll for all 12

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Instagram Graph Api Context

11 classes · 37 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

Instagram API Rules

5 rules · 4 warnings 1 info

SPECTRAL

Instagram API Rules

24 rules · 14 errors 8 warnings 2 info

SPECTRAL

JSON Schema 11

Standalone JSON Schema definitions for this provider's data models.

CommentList

2 properties

JSON SCHEMA

Comment

7 properties

JSON SCHEMA

ContainerResponse

1 properties

JSON SCHEMA

CreateContainerRequest

8 properties

JSON SCHEMA

ErrorResponse

1 properties

JSON SCHEMA

InsightsResponse

1 properties

JSON SCHEMA

MediaList

2 properties

JSON SCHEMA

Media

14 properties

JSON SCHEMA

Paging

3 properties

JSON SCHEMA

SuccessResponse

1 properties

JSON SCHEMA

User

9 properties

JSON SCHEMA

Scroll for all 11

JSON Structure 11

JSON Structure definitions describing this provider's data shapes.

Instagram Graph Api Comment List Structure

2 properties

JSON STRUCTURE

Instagram Graph Api Comment Structure

7 properties

JSON STRUCTURE

Instagram Graph Api Media List Structure

2 properties

JSON STRUCTURE

Instagram Graph Api Media Structure

14 properties

JSON STRUCTURE

Instagram Graph Api Paging Structure

3 properties

JSON STRUCTURE

Instagram Graph Api User Structure

9 properties

JSON STRUCTURE

Scroll for all 11

Examples 11

Example request and response payloads for these APIs.

Scroll for all 11

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Instagram Authentication

oauth2 · 1 scheme

SECURITY

Instagram Domain Security

TLSv1.3 · DMARC

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Instagram Scopes

7 scopes · authorizationCode

7 scopes

SCOPES

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Instagram Agentic Access

25 operations · 8 acting

25 operations · 8 acting

AGENTIC

Use Cases 8

What developers build with this provider.

Social Media Management

Automate content publishing, scheduling, and media management across Instagram accounts.

Brand Monitoring

Track mentions, comments, and hashtags to monitor brand sentiment and engagement.

Customer Service

Manage Instagram Direct conversations for customer support and business inquiries.

Analytics and Reporting

Retrieve insights and metrics for measuring content performance and audience growth.

Content Curation

Discover and curate content through hashtag search and mention tracking.

E-commerce Integration

Connect product catalogs and shopping features with Instagram content for social commerce.

Influencer Marketing

Track creator account metrics, media performance, and audience insights for influencer campaigns.

Website Embedding

Embed Instagram posts, reels, and galleries on websites and blogs using oEmbed.

Scroll for all 8

Integrations 4

Pre-built integrations with other platforms and tools.

Facebook

Unified management of Instagram and Facebook content, messaging, and advertising through the Meta platform.

Meta Business Suite

Centralized dashboard for managing Instagram and Facebook business accounts, content, and insights.

WhatsApp

Cross-platform messaging through Meta unified messaging infrastructure.

Webhooks

Real-time event notifications for comments, mentions, messages, and story insights.

Solutions 4

Packaged solutions this provider offers.

Instagram API with Instagram Login

Native Instagram authentication for Business and Creator accounts with full API access.

Instagram API with Facebook Login

Facebook Page-linked authentication for Instagram Business accounts with hashtag discovery.

Instagram Messaging

Unified messaging across Instagram Direct and Facebook Messenger for business communication.

Instagram Embedding

oEmbed and embed tools for displaying Instagram content on third-party websites.

Resources

Get Started 2

Portal, sign-up, and the first successful call

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Build 2

SDKs, sample code, and the tooling you integrate with

Access & Security 4

Authentication, authorization, and security posture

Operate 3

Status, limits, changes, and where to get help

Commercial 2

Pricing, plans, and the legal terms of use

Company 2

The organization behind the API

Source (apis.yml)

apis.yml Raw ↑
aid: instagram
name: Instagram
description: Instagram is a photo and video sharing social networking platform owned by Meta. The Instagram APIs allow developers
  to build integrations with Instagram Business and Creator accounts for content publishing, media management, comment moderation,
  hashtag discovery, insights and analytics, messaging, and embedding. Available through the Meta Developer Platform with
  Facebook Login or Instagram Login authentication.
type: Index
accessModel:
  pricing: paid
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Paid · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/instagram.png
url: https://raw.githubusercontent.com/api-evangelist/instagram/refs/heads/main/apis.yml
created: '2024-01-01'
modified: '2026-04-17'
specificationVersion: '0.19'
tags:
- Instagram
- Meta
- Photos
- Social Media
- Videos
- Content Publishing
apis:
- aid: instagram:instagram-messaging-api
  name: Instagram Messaging API
  description: The Messenger API support for Instagram consolidates Instagram and Facebook Page messaging into a unified platform.
    Enables businesses and creators to manage conversations, send and receive messages, and handle messaging automation across
    Instagram Direct.
  humanURL: https://developers.facebook.com/docs/instagram-platform/instagram-api-with-instagram-login/messaging-api
  baseURL: https://graph.instagram.com
  properties:
  - type: Documentation
    url: https://developers.facebook.com/docs/instagram-platform/instagram-api-with-instagram-login/messaging-api
  tags:
  - Direct Messages
  - Messaging
  - Social Media
- aid: instagram:instagram-oembed-api
  name: Instagram oEmbed API
  description: The Instagram oEmbed endpoint returns HTML and metadata for embedding Instagram photos, videos, reels, and
    carousels on third-party websites using the standard oEmbed protocol.
  humanURL: https://developers.facebook.com/docs/instagram-platform/oembed
  baseURL: https://graph.facebook.com
  properties:
  - type: Documentation
    url: https://developers.facebook.com/docs/instagram-platform/oembed
  tags:
  - Embedding
  - oEmbed
  - Social Media
- aid: instagram:instagram-comments-api
  name: Instagram Comments API
  description: Comment management and moderation
  humanURL: https://developers.facebook.com/docs/instagram-platform/instagram-api-with-instagram-login
  baseURL: https://graph.instagram.com
  tags:
  - Comments
  properties:
  - type: OpenAPI
    url: openapi/instagram-comments-api-openapi.yml
  - type: Documentation
    url: https://developers.facebook.com/docs/instagram-platform/instagram-api-with-instagram-login
  - type: GettingStarted
    url: https://developers.facebook.com/docs/instagram-platform/instagram-api-with-instagram-login/getting-started
  - type: APIReference
    url: https://developers.facebook.com/docs/instagram-api/reference
  - type: Authentication
    url: https://developers.facebook.com/docs/instagram-platform/instagram-api-with-instagram-login/business-login
  - type: Documentation
    url: https://developers.facebook.com/docs/instagram-api/
  - type: GettingStarted
    url: https://developers.facebook.com/docs/instagram-api/getting-started
  - type: Authentication
    url: https://developers.facebook.com/docs/instagram-api/overview#authentication
  - type: ChangeLog
    url: https://developers.facebook.com/docs/instagram-api/changelog
- aid: instagram:instagram-hashtags-api
  name: Instagram Hashtags API
  description: Hashtag search and media discovery
  humanURL: https://developers.facebook.com/docs/instagram-platform/instagram-api-with-instagram-login
  baseURL: https://graph.instagram.com
  tags:
  - Hashtags
  properties:
  - type: OpenAPI
    url: openapi/instagram-hashtags-api-openapi.yml
  - type: Documentation
    url: https://developers.facebook.com/docs/instagram-platform/instagram-api-with-instagram-login
  - type: GettingStarted
    url: https://developers.facebook.com/docs/instagram-platform/instagram-api-with-instagram-login/getting-started
  - type: APIReference
    url: https://developers.facebook.com/docs/instagram-api/reference
  - type: Authentication
    url: https://developers.facebook.com/docs/instagram-platform/instagram-api-with-instagram-login/business-login
  - type: Documentation
    url: https://developers.facebook.com/docs/instagram-api/
  - type: GettingStarted
    url: https://developers.facebook.com/docs/instagram-api/getting-started
  - type: Authentication
    url: https://developers.facebook.com/docs/instagram-api/overview#authentication
  - type: ChangeLog
    url: https://developers.facebook.com/docs/instagram-api/changelog
- aid: instagram:instagram-insights-api
  name: Instagram Insights API
  description: Account and media level analytics
  humanURL: https://developers.facebook.com/docs/instagram-platform/instagram-api-with-instagram-login
  baseURL: https://graph.instagram.com
  tags:
  - Insights
  properties:
  - type: OpenAPI
    url: openapi/instagram-insights-api-openapi.yml
  - type: Documentation
    url: https://developers.facebook.com/docs/instagram-platform/instagram-api-with-instagram-login
  - type: GettingStarted
    url: https://developers.facebook.com/docs/instagram-platform/instagram-api-with-instagram-login/getting-started
  - type: APIReference
    url: https://developers.facebook.com/docs/instagram-api/reference
  - type: Authentication
    url: https://developers.facebook.com/docs/instagram-platform/instagram-api-with-instagram-login/business-login
  - type: Documentation
    url: https://developers.facebook.com/docs/instagram-api/
  - type: GettingStarted
    url: https://developers.facebook.com/docs/instagram-api/getting-started
  - type: Authentication
    url: https://developers.facebook.com/docs/instagram-api/overview#authentication
  - type: ChangeLog
    url: https://developers.facebook.com/docs/instagram-api/changelog
- aid: instagram:instagram-media-api
  name: Instagram Media API
  description: Photos, videos, stories, reels, and carousels
  humanURL: https://developers.facebook.com/docs/instagram-platform/instagram-api-with-instagram-login
  baseURL: https://graph.instagram.com
  tags:
  - Media
  properties:
  - type: OpenAPI
    url: openapi/instagram-media-api-openapi.yml
  - type: Documentation
    url: https://developers.facebook.com/docs/instagram-platform/instagram-api-with-instagram-login
  - type: GettingStarted
    url: https://developers.facebook.com/docs/instagram-platform/instagram-api-with-instagram-login/getting-started
  - type: APIReference
    url: https://developers.facebook.com/docs/instagram-api/reference
  - type: Authentication
    url: https://developers.facebook.com/docs/instagram-platform/instagram-api-with-instagram-login/business-login
  - type: Documentation
    url: https://developers.facebook.com/docs/instagram-api/
  - type: GettingStarted
    url: https://developers.facebook.com/docs/instagram-api/getting-started
  - type: Authentication
    url: https://developers.facebook.com/docs/instagram-api/overview#authentication
  - type: ChangeLog
    url: https://developers.facebook.com/docs/instagram-api/changelog
- aid: instagram:instagram-mentions-api
  name: Instagram Mentions API
  description: Content where account was mentioned
  humanURL: https://developers.facebook.com/docs/instagram-platform/instagram-api-with-instagram-login
  baseURL: https://graph.instagram.com
  tags:
  - Mentions
  properties:
  - type: OpenAPI
    url: openapi/instagram-mentions-api-openapi.yml
  - type: Documentation
    url: https://developers.facebook.com/docs/instagram-platform/instagram-api-with-instagram-login
  - type: GettingStarted
    url: https://developers.facebook.com/docs/instagram-platform/instagram-api-with-instagram-login/getting-started
  - type: APIReference
    url: https://developers.facebook.com/docs/instagram-api/reference
  - type: Authentication
    url: https://developers.facebook.com/docs/instagram-platform/instagram-api-with-instagram-login/business-login
  - type: Documentation
    url: https://developers.facebook.com/docs/instagram-api/
  - type: GettingStarted
    url: https://developers.facebook.com/docs/instagram-api/getting-started
  - type: Authentication
    url: https://developers.facebook.com/docs/instagram-api/overview#authentication
  - type: ChangeLog
    url: https://developers.facebook.com/docs/instagram-api/changelog
- aid: instagram:instagram-publishing-api
  name: Instagram Publishing API
  description: Content creation and publishing workflow
  humanURL: https://developers.facebook.com/docs/instagram-platform/instagram-api-with-instagram-login
  baseURL: https://graph.instagram.com
  tags:
  - Publishing
  properties:
  - type: OpenAPI
    url: openapi/instagram-publishing-api-openapi.yml
  - type: Documentation
    url: https://developers.facebook.com/docs/instagram-platform/instagram-api-with-instagram-login
  - type: GettingStarted
    url: https://developers.facebook.com/docs/instagram-platform/instagram-api-with-instagram-login/getting-started
  - type: APIReference
    url: https://developers.facebook.com/docs/instagram-api/reference
  - type: Authentication
    url: https://developers.facebook.com/docs/instagram-platform/instagram-api-with-instagram-login/business-login
  - type: Documentation
    url: https://developers.facebook.com/docs/instagram-api/
  - type: GettingStarted
    url: https://developers.facebook.com/docs/instagram-api/getting-started
  - type: Authentication
    url: https://developers.facebook.com/docs/instagram-api/overview#authentication
  - type: ChangeLog
    url: https://developers.facebook.com/docs/instagram-api/changelog
- aid: instagram:instagram-users-api
  name: Instagram Users API
  description: Instagram Business and Creator account profiles
  humanURL: https://developers.facebook.com/docs/instagram-platform/instagram-api-with-instagram-login
  baseURL: https://graph.instagram.com
  tags:
  - Users
  properties:
  - type: OpenAPI
    url: openapi/instagram-users-api-openapi.yml
  - type: Documentation
    url: https://developers.facebook.com/docs/instagram-platform/instagram-api-with-instagram-login
  - type: GettingStarted
    url: https://developers.facebook.com/docs/instagram-platform/instagram-api-with-instagram-login/getting-started
  - type: APIReference
    url: https://developers.facebook.com/docs/instagram-api/reference
  - type: Authentication
    url: https://developers.facebook.com/docs/instagram-platform/instagram-api-with-instagram-login/business-login
  - type: Documentation
    url: https://developers.facebook.com/docs/instagram-api/
  - type: GettingStarted
    url: https://developers.facebook.com/docs/instagram-api/getting-started
  - type: Authentication
    url: https://developers.facebook.com/docs/instagram-api/overview#authentication
  - type: ChangeLog
    url: https://developers.facebook.com/docs/instagram-api/changelog
common:
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/instagram/overview
- type: AgenticAccess
  url: agentic-access/instagram-agentic-access.yml
- type: DomainSecurity
  url: security/instagram-domain-security.yml
- type: Authentication
  url: authentication/instagram-authentication.yml
- type: OAuthScopes
  url: scopes/instagram-scopes.yml
- type: LinkedIn
  url: https://www.linkedin.com/company/instagram
- type: Portal
  url: https://developers.facebook.com/docs/instagram-platform
- type: GettingStarted
  url: https://developers.facebook.com/docs/instagram-api/getting-started
- type: Authentication
  url: https://developers.facebook.com/docs/instagram-api/overview#authentication
- type: TermsOfService
  url: https://developers.facebook.com/terms
- type: PrivacyPolicy
  url: https://www.facebook.com/privacy/explanation
- type: StatusPage
  url: https://developers.facebook.com/status/
- type: ChangeLog
  url: https://developers.facebook.com/docs/instagram-api/changelog
- type: Support
  url: https://developers.facebook.com/support
- type: Blog
  url: https://developers.facebook.com/blog/
- type: GitHubOrganization
  url: https://github.com/fbsamples
- type: Features
  data:
  - name: Content Publishing
    description: Publish photos, videos, reels, carousels, and stories to Instagram Business and Creator accounts programmatically.
  - name: Media Management
    description: Retrieve, manage, and organize published media including photos, videos, stories, and albums.
  - name: Comment Moderation
    description: Read, reply to, hide, and delete comments on Instagram media for brand safety and engagement.
  - name: Hashtag Discovery
    description: Search for hashtags and discover top and recent media associated with specific hashtags.
  - name: Mention Tracking
    description: Identify and retrieve media where your account has been mentioned by other Instagram users.
  - name: Insights and Analytics
    description: Access account-level and media-level metrics for reach, impressions, engagement, and audience demographics.
  - name: Instagram Direct Messaging
    description: Send and receive messages through Instagram Direct for customer service and business communication.
  - name: Stories Publishing
    description: Publish ephemeral story content including photos and videos that disappear after 24 hours.
  - name: Reels Publishing
    description: Create and publish short-form video content as Instagram Reels.
  - name: oEmbed
    description: Embed Instagram posts, reels, and videos on third-party websites using the standard oEmbed protocol.
  - name: Webhooks
    description: Receive real-time notifications for comments, mentions, messages, and story insights via webhooks.
  - name: Private Replies
    description: Send private direct messages in response to public comments on your Instagram media.
- type: UseCases
  data:
  - name: Social Media Management
    description: Automate content publishing, scheduling, and media management across Instagram accounts.
  - name: Brand Monitoring
    description: Track mentions, comments, and hashtags to monitor brand sentiment and engagement.
  - name: Customer Service
    description: Manage Instagram Direct conversations for customer support and business inquiries.
  - name: Analytics and Reporting
    description: Retrieve insights and metrics for measuring content performance and audience growth.
  - name: Content Curation
    description: Discover and curate content through hashtag search and mention tracking.
  - name: E-commerce Integration
    description: Connect product catalogs and shopping features with Instagram content for social commerce.
  - name: Influencer Marketing
    description: Track creator account metrics, media performance, and audience insights for influencer campaigns.
  - name: Website Embedding
    description: Embed Instagram posts, reels, and galleries on websites and blogs using oEmbed.
- type: Integrations
  data:
  - name: Facebook
    description: Unified management of Instagram and Facebook content, messaging, and advertising through the Meta platform.
  - name: Meta Business Suite
    description: Centralized dashboard for managing Instagram and Facebook business accounts, content, and insights.
  - name: WhatsApp
    description: Cross-platform messaging through Meta unified messaging infrastructure.
  - name: Webhooks
    description: Real-time event notifications for comments, mentions, messages, and story insights.
- type: Solutions
  data:
  - name: Instagram API with Instagram Login
    description: Native Instagram authentication for Business and Creator accounts with full API access.
  - name: Instagram API with Facebook Login
    description: Facebook Page-linked authentication for Instagram Business accounts with hashtag discovery.
  - name: Instagram Messaging
    description: Unified messaging across Instagram Direct and Facebook Messenger for business communication.
  - name: Instagram Embedding
    description: oEmbed and embed tools for displaying Instagram content on third-party websites.
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com