Instagram Publishing API

Content creation and publishing workflow

Documentation GitHub OpenAPI

Business capability

Operations 4

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /{user_id}/media Prepare a photo or video for publishing · Instagram Create Media Container #

Ask an LLM

“What's the first step to post a photo to Instagram through the API?”

“Can I add a caption, location and user tags when staging a post?”

Tell an agent

Create a media container for account {user_id} from image {image_url} with caption {caption}.

Stage video {video_url} of type {media_type} for account {user_id}.

POST /{user_id}/media_publish Publish a prepared media container · Instagram Publish Media Container #

Ask an LLM

“Once my container is ready, how do I actually make the post go live?”

“What's the final step of the two-step Instagram publishing flow?”

Tell an agent

Publish container {creation_id} to account {user_id}.

Make staged post {creation_id} live on account {user_id}.

GET /{user_id}/content_publishing_limit Check how many posts I can still publish · Instagram Get Content Publishing Limit #

Ask an LLM

“How close am I to the publishing rate limit on my account?”

“Can I check my current content publishing usage before posting more?”

Tell an agent

Show the content publishing limit usage for account {user_id}.

Check the publishing quota for account {user_id} with fields {fields}.

GET /{container_id} Check the status of a media container · Instagram Get Container Status #

Ask an LLM

“Is my uploaded video container finished processing and ready to publish?”

“Why hasn't my staged post published yet — what status is its container in?”

Tell an agent

Check the publishing status of container {container_id}.

Get fields {fields} for media container {container_id}.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/instagram:instagram-publishing-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Instagram Graph Publishing API
  description: The Instagram Graph API allows Instagram Professionals (Business and Creator accounts) to manage their presence on Instagram, including media publishing, comments, hashtags, mentions, insights, and messaging. Uses the Facebook Graph API infrastructure with OAuth 2.0 authentication.
  version: '21.0'
  contact:
    name: Meta for Developers
    url: https://developers.facebook.com/docs/instagram-api
  license:
    name: Meta Platform Terms
    url: https://developers.facebook.com/terms
servers:
- url: https://graph.facebook.com/v21.0
  description: Facebook Graph API (Facebook Login)
- url: https://graph.instagram.com/v21.0
  description: Instagram Graph API (Instagram Login)
tags:
- name: Publishing
  description: Content creation and publishing workflow
paths:
  /{user_id}/media:
    post:
      operationId: createMediaContainer
      summary: Instagram Create Media Container
      description: Create a media container for publishing content. Step 1 of the publishing flow.
      tags:
      - Publishing
      parameters:
      - name: user_id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateContainerRequest'
      responses:
        '200':
          description: Container created.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContainerResponse'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /{user_id}/media_publish:
    post:
      operationId: publishMedia
      summary: Instagram Publish Media Container
      description: Publish a media container. Step 2 of the publishing flow.
      tags:
      - Publishing
      parameters:
      - name: user_id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - creation_id
              - access_token
              properties:
                creation_id:
                  type: string
                  description: The container ID from createMediaContainer.
                  example: '17889615691921648'
                access_token:
                  type: string
      responses:
        '200':
          description: Media published.
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: The published media ID.
                    example: '17854360229135492'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /{user_id}/content_publishing_limit:
    get:
      operationId: getContentPublishingLimit
      summary: Instagram Get Content Publishing Limit
      description: Get current content publishing usage and rate limit status.
      tags:
      - Publishing
      parameters:
      - name: user_id
        in: path
        required: true
        schema:
          type: string
      - name: fields
        in: query
        schema:
          type: string
        example: config,quota_usage
      - name: access_token
        in: query
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Publishing limit data.
          content:
            application/json:
              schema:
                type: object
                properties:
                  config:
                    type: object
                    properties:
                      quota_total:
                        type: integer
                        example: 100
                      quota_duration:
                        type: integer
                        example: 86400
                  quota_usage:
                    type: integer
                    example: 5
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /{container_id}:
    get:
      operationId: getContainer
      summary: Instagram Get Container Status
      description: Check the publishing status of a media container.
      tags:
      - Publishing
      parameters:
      - name: container_id
        in: path
        required: true
        schema:
          type: string
      - name: fields
        in: query
        schema:
          type: string
        example: status_code,status
      - name: access_token
        in: query
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Container status.
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  status_code:
                    type: string
                    enum:
                    - EXPIRED
                    - ERROR
                    - FINISHED
                    - IN_PROGRESS
                    - PUBLISHED
                    example: FINISHED
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  schemas:
    ContainerResponse:
      type: object
      properties:
        id:
          type: string
          description: The container ID.
          example: '17889615691921648'
    CreateContainerRequest:
      type: object
      properties:
        image_url:
          type: string
          description: Public URL of the image to publish.
          example: https://www.example.com/images/photo.jpg
        video_url:
          type: string
          description: Public URL of the video to publish.
        caption:
          type: string
          description: Caption text for the media.
          example: 'Check out our latest product! #newlaunch'
        media_type:
          type: string
          description: Type of media to publish.
          enum:
          - IMAGE
          - VIDEO
          - REELS
          - STORIES
          - CAROUSEL
          example: IMAGE
        is_carousel_item:
          type: boolean
          description: Set to true if this is an item in a carousel.
          example: false
        location_id:
          type: string
          description: Facebook Page ID of a location to tag.
        user_tags:
          type: array
          description: Users to tag in the media.
          items:
            type: object
            properties:
              username:
                type: string
              x:
                type: number
              y:
                type: number
        access_token:
          type: string
  securitySchemes:
    oauth2:
      type: oauth2
      description: OAuth 2.0 authentication via Instagram Login or Facebook Login.
      flows:
        authorizationCode:
          authorizationUrl: https://www.facebook.com/dialog/oauth
          tokenUrl: https://graph.facebook.com/oauth/access_token
          scopes:
            instagram_basic: Read user profile and media.
            instagram_content_publish: Publish content on behalf of the user.
            instagram_manage_comments: Manage comments on media.
            instagram_manage_insights: Access insights and analytics.
            instagram_manage_messages: Manage Instagram Direct messages.
            pages_show_list: Show list of pages managed by user.
            pages_read_engagement: Read engagement data from pages.
externalDocs:
  description: Instagram Platform Documentation
  url: https://developers.facebook.com/docs/instagram-platform

Instagram Publishing API

Operations 4

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification