Instagram API · DM 자동화 전수조사 (2026.06)

1 Instagram 공식 API 전수조사

2026년 6월 현재 Meta가 사용 가능 상태로 유지하는 모든 Instagram 관련 API를 한 화면에 매핑.

1-1. 전체 매트릭스

1-2. 계정 타입별 접근성

• Business / Creator (Professional): Platform API 전체 사용 가능.
• Personal: API 접근 불가 (Basic Display 종료로 우회 경로 없음). Business 전환 권장.

2 Messaging API (DM)

발신·수신 자동화의 핵심 API. 24시간 윈도우 룰이 모든 설계의 출발점.

2-1. 지원 메시지 타입

2-2. 핵심 엔드포인트

POST /{ig-user-id}/messages          # DM 전송
POST /{ig-user-id}/messages          # mark_seen / typing_on / typing_off (sender_action)
GET  /{conversation-id}              # 대화 조회
GET  /me/conversations               # 대화 목록

2-3. 필수 권한 & Webhook 구독

• 권한: instagram_business_basic + instagram_business_manage_messages (IG Login) 또는 instagram_manage_messages (FB Login)
• Webhook fields: messages, message_echoes, message_reactions, messaging_handover, messaging_optins, messaging_postbacks, messaging_referral, messaging_seen, messaging_policy_enforcement, standby

3 Content Publishing · Insights · Hashtag

3-1. Content Publishing

Media Type별 엔드포인트

발행 플로우

1) POST /{ig-id}/media              # container 생성 → creation_id
2) (video) GET /{creation-id}?fields=status_code   # FINISHED 까지 polling
3) POST /{ig-id}/media_publish      # creation_id 로 게시

미지원 쇼핑 태그 · 필터 · 위치 태그 일부.

3-2. Insights API

• 데이터 지연 최대 48시간. Demographic top 45만 반환.
• 권한: instagram_business_manage_insights (IG Login) / instagram_manage_insights + pages_read_engagement (FB Login)

3-3. Hashtag Search

• 검색 한도: 계정당 30개 hashtag / 7일 rolling — 캐싱 전략 필수.
• 엔드포인트: GET /ig_hashtag_search?user_id=&q= → hashtag ID → /{hashtag-id}/top_media · /recent_media
• 반환: id, media_type, comments_count, like_count, caption, permalink, timestamp

4 Comments · Mentions · Discovery · Webhook

4-1. Mentions & Comments

4-2. Business / User Discovery

• 용도: 다른 비즈니스/크리에이터 계정의 공개 데이터 조회
• 엔드포인트: GET /{ig-user-id}?fields=business_discovery.username(TARGET){...}
• 반환: followers_count, media_count, profile_picture_url, biography, media{}
• 권한: instagram_basic (FB Login). IG Login에서는 제한적.
• 한계: 비공개/개인 계정 조회 불가. username을 이미 알고 있어야 함 (검색/디스커버리 불가).

4-3. Webhook 전체 목록

검증: HTTPS endpoint, hub.verify_token, payload X-Hub-Signature-256 (SHA256) 검증, /me/subscribed_apps 구독.

5 Threads API

Meta가 Instagram과 별개로 운영하는 텍스트 SNS. Webhook도 분리.

24시간 Rate Limit

사용량 조회: GET /{threads-user-id}/threads_publishing_limit

핵심 엔드포인트

POST /{user-id}/threads            # container 생성 (TEXT|IMAGE|VIDEO|CAROUSEL)
POST /{user-id}/threads_publish    # 게시
POST /{media-id}/repost            # 리포스트
DELETE /{media-id}                 # 삭제
GET  /{user-id}/threads            # 본인 게시물 목록
GET  /{media-id}/replies           # 답글 트리
GET  /{media-id}/conversation      # 대화 전체
POST /{media-id}/manage_reply      # 답글 hide/unhide
GET  /{user-id}/threads_insights   # 인사이트
GET  /keyword_search               # 키워드 검색
GET  /mentions                     # 멘션 조회

옵션 파라미터

• reply_control (everyone / accounts_you_follow / mentioned_only)
• allowlisted_country_codes (지역 제한)
• alt_text (1000자)
• poll_attachment (옵션 2~4개)
• is_spoiler, topic_tag (., & 금지)
• auto_publish_text — container 생성 시 자동 게시 (텍스트 전용)

Webhook (Threads, IG와 분리)

threads_mentions, threads_replies, threads_insights

6 Login / OAuth · Basic Display 종료

6-1. 새 스코프 (2025-01-27 이후)

6-2. 토큰 라이프사이클

6-3. Basic Display API EOL

7 Breaking Changes 타임라인

8 DM 자동화 SaaS 전수비교 (글로벌+한국)

2026년 6월 기준. 공식 Meta Business Partner 인증 = 안전, 비공식 우회 = 차단 위험.

8-1. 공식 Meta Business Partner 기반 (안전)

8-2. 비공식 / 차단 위험군

8-3. 한국 서비스

9 공식 API의 제약 vs 비공식 우회 패턴

9-1. Graph Messaging API 제약 한눈에

9-2. 비공식 우회의 한계 (2026 현실)

• 브라우저 자동화 (Selenium): Instagram timing 패턴 ML이 스크립트 input과 real touch를 구분 → 즉시 hard ban.
• 모바일 디바이스 에뮬: 디바이스 fingerprint 탐지 강화. 효과 급감.
• 패스워드 기반 로그인 후 send: ToS 위반 + suspicious login → freeze.

10 자체 구축 vs SaaS 비용·기능

10-1. 자체 구축 시 컴포넌트

• Meta IG Graph 앱 등록 + Business Verification (2~6주 소요)
• Webhook 수신 서버 (Cloudflare Workers / Vercel / 자체 BE)
• Postgres/Redis (세션·24h 윈도우·rate limit)
• LLM API (Claude Sonnet ≈ $3/M in, $15/M out · Gemini Flash 더 저렴)
• 큐/재시도 (BullMQ), 모니터링, 로그
• Meta App Review (Instagram Messaging permission 승인) — 가장 큰 진입 장벽

10-2. 비용 시뮬레이션 (월 1만 대화)

10-3. 결정 기준

11 기능 ① LLM 대화 기반 유명 크리에이터 추천 구현 가능성

"뷰티 카테고리에서 팔로워 10만~30만, 인게이지 5%+ 한국 인플루언서 추천해줘" 같은 자연어 요청 처리.

11-1. 필요한 데이터

• 카테고리 (뷰티/패션/IT/요리 등)
• 팔로워 수, 인게이지율
• 지역 / 언어 / 평균 likes·comments / 평균 reels views
• 가짜팔로워 비율 (audience quality)
• 최근 게시 빈도, 협업 이력

11-2. IG 공식 API로 어디까지 되나

11-3. 3rd party 인플루언서 DB 비교

11-4. 권장 아키텍처

User: "뷰티 카테고리 한국 인플루언서, 팔로워 5만~20만, 인게이지 4%+ 추천"
        │
        ▼
┌─────────────────────────┐
│  LLM (Claude/GPT-5)     │  ← system prompt에 tool schema 주입
│  - 의도 파싱            │
│  - Tool call 결정       │
└──────────┬──────────────┘
           ▼
┌─────────────────────────┐
│  search_creators(...)   │  ← Phyllo/Modash REST API
│  category=beauty         │
│  country=KR              │
│  followers=[50k,200k]   │
│  engagement_min=0.04    │
└──────────┬──────────────┘
           ▼
┌─────────────────────────┐
│  LLM: 결과 reasoning    │
│  - top N 추천 + 근거    │
│  - 다음 액션 제안       │
└─────────────────────────┘

11-5. 구현 난이도

• 난이도: Low~Medium. tool-calling 표준 패턴.
• 리스크: 3rd party DB 비용 ($300~$3,000/월). 한국 커버리지는 AnyTag/인플라이트가 우세 — 국내 타깃이면 국산 DB 컨택이 ROI 좋음.
• 법적: 인플루언서 DB의 공개 데이터 스크래핑은 Meta ToS 회색 — 정식 라이선스 SaaS 사용 권장.

12 기능 ② 대화 시작으로 DM 보내기 자동화 (Cold DM) 구현 가능성

"추천된 크리에이터들에게 자동으로 '협업 제안' DM 일괄 발송".

12-1. 24시간 윈도우 룰의 본질

Messaging API는 유저가 먼저 메시지/액션을 해야만 비즈니스가 응답할 수 있음. 우리가 먼저 보내는 cold DM은 API 자체가 막아놓음 — 권한·rate limit 문제가 아니라 구조적 차단.

12-2. 우회 경로 7가지 분석

12-3. Click-to-Message Ads 상세

• Facebook Ads Manager에서 IG 광고 출고 → "Send Message" CTA → 클릭 시 자동으로 24h 윈도우 열림 + 봇 응대 가능.
• 타게팅: Meta Audience(관심사·연령·지역). 인플루언서 1:1 타게팅은 불가, 분포 도달만.
• 예산: KRW 1만~ /일 가능. 클릭당 비용 KRW 500~3,000 수준 (산업별).
• 장점: 100% 정책 안전. 응대 후 LLM 봇 자유 운용.
• 한계: 우리가 원하는 "특정 인플루언서 X명에게 정확히" 발송은 안 됨.

12-4. Cold Outreach 합법 채널 (린다세일즈 본업)

• 이메일 cold outreach — SendGrid(이미 인프라 보유) + 인플루언서 이메일은 IG bio·링크드인·MailHunter API로 발견. CAN-SPAM·KISA·GDPR 준수 시 합법.
• LinkedIn Sales Navigator — Sales Nav API + Connection request + InMail. 인플루언서가 LinkedIn에 본업 프로필 둔 경우 효과적.
• 이메일 답장 받음 → 그 안에 IG 핸들 받음 → 사용자가 먼저 액션하도록 유도 → 그 시점부터 IG DM 자동화 합법적 시작.

12-5. 결론 매트릭스

13 권장 아키텍처 (린다세일즈 매핑)

13-1. 전체 플로우

┌──────────────────────────────────────────────────────────┐
│  1. LLM 대화                                              │
│  "뷰티 한국, 5~20만 팔로워, 인게이지 4%+ 추천"           │
│         │                                                  │
│         ▼                                                  │
│  Phyllo/AnyTag API  →  후보 50명 + 메타데이터           │
└──────────────────────────────────────────────────────────┘
                          │
                          ▼
┌──────────────────────────────────────────────────────────┐
│  2. Outreach 채널 분기                                    │
│  ① 이메일 발견 (bio·블로그·MailHunter)                   │
│     → SendGrid cold outreach (기존 인프라 활용)          │
│  ② LinkedIn 발견                                          │
│     → Sales Nav InMail                                    │
│  ③ 이메일·LinkedIn 모두 없으면 → CTM Ads 또는 보류       │
└──────────────────────────────────────────────────────────┘
                          │
                          ▼
┌──────────────────────────────────────────────────────────┐
│  3. 답장 received                                         │
│  - 메일/LinkedIn 답장 → CRM 기록                          │
│  - 인플루언서가 IG로 먼저 DM/스토리 답장 →                │
│    24h 윈도우 OPEN → IG Messaging API 자동 응대 가능     │
└──────────────────────────────────────────────────────────┘
                          │
                          ▼
┌──────────────────────────────────────────────────────────┐
│  4. IG DM 봇 (LLM)                                        │
│  - Webhook(messages) 수신 → LLM(Claude/GPT) → DM 응답   │
│  - 24h 초과 시 Human Agent tag로 7일 연장 (사람 응대)    │
│  - 협업 조건 협상 → 계약 → 캠페인 발행                  │
└──────────────────────────────────────────────────────────┘

13-2. 기술 스택 (현재 send-grid-test 매핑)

13-3. MVP 일정 (현실적 추정)

14 Sources

Instagram 공식 문서

• Changelog - Instagram Platform
• Overview - Instagram Platform
• Instagram Platform Webhooks
• Messaging API (Instagram Login)
• Publish Content using the Instagram Platform
• Threads API
• Threads Publishing
• Instagram APIs Hub

API 변경 / 분석 글

• Instagram Basic Display API Deprecation — Phyllo
• Instagram Graph API Complete Developer Guide 2026 — Elfsight
• Instagram Messaging API Integration 2026 — Zernio
• Threads API Documentation 2026 — Zernio
• Threads API Pricing 2026 — Blotato
• Instagram API Pricing 2026 — Phyllo
• Instagram API Rate Limits 2026 — CreatorFlow
• IG Messaging API 24h Window Policy
• IG DM Rate Limits 2026 — InstantDM

DM 자동화 SaaS

• 10 IG DM Automation Tools Compared 2026
• 15 Best ManyChat Alternatives 2026
• ManyChat for Instagram
• Chatfuel for Instagram
• Tidio Pricing 2026
• Best Instagram Chatbots 2026 — Respond.io
• Botsify Pricing
• Trengo Pricing
• Wati Pricing
• Engati Pricing
• ReplyRush Review 2026
• Inro IG DM Automation
• FlowGent IG Channel
• Is IG Automation Safe 2026
• AI Agents for IG DMs
• Complete Guide to IG DM Automation with AI Agents

한국 서비스

• TodayDM
• KittyChat
• 채널톡 IG DM 연동 — Venture Square
• 인스타 자동 DM 완전 가이드 — Mirra