bldinit Instagram Rest API
The instagram-rest API from bldinit — 14 operation(s) for instagram-rest.
The instagram-rest API from bldinit — 14 operation(s) for instagram-rest.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/mcpweave-com:mcpweave-com-instagram-rest-api"
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.
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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: mcpweave Instagram Rest API
description: Asia-native MCP Gateway — Native pass-through, FastMCP, Paddle+Toss billing
version: '2026-04-27'
tags:
- name: instagram-rest
paths:
/api/v1/instagram/{ig_user_id}:
get:
tags:
- instagram-rest
summary: Instagram Business 계정 프로필
description: '``ig_user_id`` (Instagram Business Account ID) 의 프로필 metadata —
username / name / followers_count / media_count / biography 등.
Native pass-through.'
operationId: instagram_get_profile
parameters:
- name: ig_user_id
in: path
required: true
schema:
type: string
title: Ig User Id
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: fields
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Fields
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/instagram/{ig_user_id}/media:
get:
tags:
- instagram-rest
summary: 내 미디어 list
description: 'Instagram Business 계정의 게시된 미디어 list (image / video / carousel).
Pagination: ``after`` cursor.
Native pass-through.'
operationId: instagram_list_media
parameters:
- name: ig_user_id
in: path
required: true
schema:
type: string
title: Ig User Id
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: fields
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Fields
- name: limit
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Limit
- name: after
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: After
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
post:
tags:
- instagram-rest
summary: 미디어 container 생성 (publishing 1단계)
description: '**Publishing 2-step 의 1단계** — 게시될 미디어의 container 생성.
container_id 발급 후 ``instagram_publish_container`` 로 실제 publish.
``image_url`` (single image) 또는 ``video_url`` (video). 외부 URL =
Meta 가 fetch (URL 은 publicly accessible 해야 함).
Carousel (multiple images) = 별도 child container 흐름 (Phase 2 trigger).
Recoverable — container 는 staged 상태 (24h 이내 publish 안 하면
자동 expire). 자체로는 외부 노출 X.
Native pass-through.'
operationId: instagram_create_media_container
parameters:
- name: ig_user_id
in: path
required: true
schema:
type: string
title: Ig User Id
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
requestBody:
content:
application/json:
schema:
anyOf:
- type: object
additionalProperties: true
- type: 'null'
title: Body
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/instagram/{ig_user_id}/media_publish:
post:
tags:
- instagram-rest
summary: Container publish (★ irreversible — public 노출)
description: '**Publishing 2-step 의 2단계** — ``creation_id`` (container_id) 를 받아
실제 게시. 이 시점에 followers + 공개 viewers 에게 노출.
**Irreversible (ADR-028/030 Cat A — 외부 도달)**: 게시 후 followers
피드 노출. mcpweave 가 미디어 삭제 가능하지만 노출 흔적 (캐시 / 인용 /
screenshot) 회수 불가.
Native pass-through.'
operationId: instagram_publish_container
parameters:
- name: ig_user_id
in: path
required: true
schema:
type: string
title: Ig User Id
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: confirmation_token
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: 'ADR-030: required for irreversible op. First call returns token.'
title: Confirmation Token
description: 'ADR-030: required for irreversible op. First call returns token.'
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
requestBody:
content:
application/json:
schema:
anyOf:
- type: object
additionalProperties: true
- type: 'null'
title: Body
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/instagram/{ig_media_id}:
get:
tags:
- instagram-rest
summary: 미디어 detail
description: 특정 게시물의 metadata. Native pass-through.
operationId: instagram_get_media
parameters:
- name: ig_media_id
in: path
required: true
schema:
type: string
title: Ig Media Id
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: fields
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Fields
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/instagram/{ig_media_id}/comments:
get:
tags:
- instagram-rest
summary: 미디어 댓글 list
description: '``ig_media_id`` 의 top-level 댓글 list. Pagination ``after`` cursor.
Native pass-through.'
operationId: instagram_list_comments
parameters:
- name: ig_media_id
in: path
required: true
schema:
type: string
title: Ig Media Id
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: fields
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Fields
- name: limit
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Limit
- name: after
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: After
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/instagram/{ig_comment_id}/replies:
post:
tags:
- instagram-rest
summary: 댓글에 답글 작성 (★ irreversible)
description: '기존 댓글 (``ig_comment_id``) 에 답글 작성. post owner + viewers 에게
공개 노출.
**Irreversible (ADR-028/030 Cat A — 외부 도달)**.
Native pass-through.'
operationId: instagram_reply_comment
parameters:
- name: ig_comment_id
in: path
required: true
schema:
type: string
title: Ig Comment Id
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: confirmation_token
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: 'ADR-030: required for irreversible op. First call returns token.'
title: Confirmation Token
description: 'ADR-030: required for irreversible op. First call returns token.'
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
requestBody:
content:
application/json:
schema:
anyOf:
- type: object
additionalProperties: true
- type: 'null'
title: Body
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/instagram/{ig_media_id}/insights:
get:
tags:
- instagram-rest
summary: 미디어 인사이트 (engagement / impressions / reach)
description: '미디어 별 metrics. ``metric`` 은 comma-separated.
Common metrics: ``engagement,impressions,reach,saved,video_views``.
media_type 별 사용 가능 metric 다름 — Meta docs 참조.
Native pass-through.'
operationId: instagram_get_media_insights
parameters:
- name: ig_media_id
in: path
required: true
schema:
type: string
title: Ig Media Id
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: metric
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Metric
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/instagram/{ig_user_id}/insights:
get:
tags:
- instagram-rest
summary: 계정 인사이트 (audience / follower demographics)
description: '계정 단위 metrics. ``metric`` + ``period`` (day / week / days_28 /
lifetime). audience metric 은 ``period=lifetime`` + ``metric_type=total_value``.
Common metrics:
- ``follower_count`` (period=day) — 팔로워수 시간별
- ``audience_city`` / ``audience_country`` / ``audience_gender_age`` (lifetime)
- ``impressions`` / ``reach`` / ``profile_views`` (day/week/days_28)
Native pass-through.'
operationId: instagram_get_account_insights
parameters:
- name: ig_user_id
in: path
required: true
schema:
type: string
title: Ig User Id
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: metric
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Metric
- name: period
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Period
- name: metric_type
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Metric Type
- name: since
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Since
- name: until
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Until
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/instagram/{ig_user_id}/content_publishing_limit:
get:
tags:
- instagram-rest
summary: 콘텐츠 발행 한도 조회 (24h 잔여)
description: 'IG Business 계정의 24시간 콘텐츠 발행 한도 조회.
``quota_usage`` (사용량) + ``config`` (``quota_total`` / ``quota_duration`` 초) 반환.
발행 전 잔여 한도 확인 용도 — 초과 시 Meta 가 발행 거부(오류).
**응답 shape** (Graph API content_publishing_limit):
``data[0].config.quota_total`` (기본 ~50/24h),
``data[0].config.quota_duration`` (86400초),
``data[0].quota_usage`` (현재 사용량).
Native pass-through.'
operationId: instagram_get_publishing_limit
parameters:
- name: ig_user_id
in: path
required: true
schema:
type: string
title: Ig User Id
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: fields
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Fields
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/instagram/{ig_user_id}/media/carousel_item:
post:
tags:
- instagram-rest
summary: 캐러셀 child container 생성 (1단계)
description: '캐러셀 게시물의 **개별 슬라이드 container** 생성. ``is_carousel_item=true`` 필수.
``image_url`` (이미지) 또는 ``video_url`` (동영상) 중 하나 제공.
반환된 ``id`` 를 ``instagram_create_carousel_container`` 의 ``children`` 에 사용.
Recoverable — staged container (24h auto-expire, 외부 노출 X).
**경로 매핑**: 실제 Graph API endpoint = ``POST /{ig-user-id}/media`` 에
``is_carousel_item=true`` body param 추가. mcpweave 경로는 명시적으로 분리.
Native pass-through.'
operationId: instagram_create_carousel_item
parameters:
- name: ig_user_id
in: path
required: true
schema:
type: string
title: Ig User Id
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
requestBody:
content:
application/json:
schema:
anyOf:
- type: object
additionalProperties: true
- type: 'null'
title: Body
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/instagram/{ig_user_id}/media/carousel:
post:
tags:
- instagram-rest
summary: 캐러셀 container 생성 (2단계, 발행 전)
description: '**캐러셀 발행 흐름의 2단계** — child container ID 목록을 묶어 carousel container 생성.
생성 후 ``instagram_publish_container`` (creation_id=carousel container ID) 로 발행.
``children``: child container ID comma-separated 문자열 (예: ``"id1,id2,id3"``).
**Meta Graph API 명세**: 2~10개 child container ID (comma-separated string 형식).
Recoverable — staged container (24h auto-expire, 발행 전 외부 노출 X).
**경로 매핑**: 실제 Graph API endpoint = ``POST /{ig-user-id}/media`` 에
``media_type=CAROUSEL`` + ``children`` 추가. mcpweave 경로 명시적 분리.
Native pass-through.'
operationId: instagram_create_carousel_container
parameters:
- name: ig_user_id
in: path
required: true
schema:
type: string
title: Ig User Id
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
requestBody:
content:
application/json:
schema:
anyOf:
- type: object
additionalProperties: true
- type: 'null'
title: Body
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/instagram/{ig_user_id}/media/reel:
post:
tags:
- instagram-rest
summary: 릴스 container 생성 (발행 전)
description: 'Instagram Reels container 생성. 생성 후 ``instagram_publish_container``
(creation_id=reel container ID) 로 발행.
``video_url`` 은 publicly accessible MP4/MOV URL. Meta 가 URL fetch 후 처리
(인코딩 비동기 — 완료 전 publish 시 ``MEDIA_NOT_READY`` 오류). 발행 전
``GET /{container-id}?fields=status_code`` 로 ``FINISHED`` 확인 권장.
**``instagram_content_publish`` 스코프가 REELS 생성·발행 모두 커버** (Graph API
content_publishing_limit 공식 문서 확인 — ADR-038 Phase 2 Amendment 2026-06-10).
Recoverable — staged container (24h auto-expire, 외부 노출 X).
Native pass-through.'
operationId: instagram_create_reel
parameters:
- name: ig_user_id
in: path
required: true
schema:
type: string
title: Ig User Id
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
requestBody:
content:
application/json:
schema:
anyOf:
- type: object
additionalProperties: true
- type: 'null'
title: Body
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/instagram/{ig_user_id}/media/story:
post:
tags:
- instagram-rest
summary: 스토리 container 생성 (발행 전)
description: 'Instagram Stories container 생성. 생성 후 ``instagram_publish_container``
(creation_id=story container ID) 로 발행.
``image_url`` 또는 ``video_url`` 중 하나 필수. 비율 9:16 권장.
스토리는 24h 후 자동 만료 (Instagram 정책 — 삭제 없이 소멸).
**``instagram_content_publish`` 스코프가 STORIES 생성·발행 모두 커버** (Graph API
공식 문서 확인 — ADR-038 Phase 2 Amendment 2026-06-10).
Recoverable — staged container (24h auto-expire, 외부 노출 X).
Native pass-through.'
operationId: instagram_create_story
parameters:
- name: ig_user_id
in: path
required: true
schema:
type: string
title: Ig User Id
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
requestBody:
content:
application/json:
schema:
anyOf:
- type: object
additionalProperties: true
- type: 'null'
title: Body
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/instagram/{ig_comment_id}:
delete:
tags:
- instagram-rest
summary: 댓글 영구 삭제 (★ irreversible)
description: 'Instagram 댓글을 **영구 삭제**. 복구 API 없음 — 삭제 즉시 비가역.
**Irreversible (ADR-028/030 Cat B — 영구 삭제)**: 댓글 + 하위 답글 전부 삭제.
취소 불가.
Native pass-through.'
operationId: instagram_delete_comment
parameters:
- name: ig_comment_id
in: path
required: true
schema:
type: string
title: Ig Comment Id
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: confirmation_token
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: 'ADR-030: required for irreversible op. First call returns token.'
title: Confirmation Token
description: 'ADR-030: required for irreversible op. First call returns token.'
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
post:
tags:
- instagram-rest
summary: 댓글 숨김/숨김 해제 (토글)
description: 'Instagram 댓글을 숨기거나 숨김 해제. ``hide=true`` 로 숨김,
``hide=false`` 로 복구 가능 — **reversible**.
댓글 작성자 본인에게는 댓글이 보이지만, 다른 사용자에게는 안 보임.
Native pass-through.'
operationId: instagram_hide_comment
parameters:
- name: ig_comment_id
in: path
required: true
schema:
type: string
title: Ig Comment Id
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: hide
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Hide
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)