Instagram API

공개 Instagram 데이터 API

Name: Instagram Data API
Brand: SocialCrawl
Availability: InStock

SocialCrawl API 키로 공개 Instagram 데이터를 구조화 JSON으로 가져옵니다. Post, Comment, Author 스키마는 다른 플랫폼과 같습니다. 호출은 크레딧으로 과금됩니다.

문서 보기 동작 방식 직접 호출

/v1/instagram

활성 엔드포인트는 33개입니다.

GET /v1/instagram/profile
GET /v1/instagram/profile/full
GET /v1/instagram/profile/posts
GET /v1/instagram/profile/reels
GET /v1/instagram/post
GET /v1/instagram/post/comments
GET /v1/instagram/media/transcript
GET /v1/instagram/search/hashtag
GET /v1/instagram/search/reels
GET /v1/instagram/stories

Instagram 엔드포인트

공개 Instagram 읽기 엔드포인트는 33개입니다. 프로필, 게시물, 릴스, 스토리, 댓글, 대본, 해시태그·위치 검색을 제공합니다. 데이터 API만 지원합니다.

프로필

1 크레딧

/v1/instagram/profile

공개 프로필 정보를 반환합니다. 표시 이름, 소개, 카운터, URL이 포함됩니다.

handle, trim

전체 프로필

5 크레딧

/v1/instagram/profile/full

공개 전체 프로필 정보를 반환합니다. 표시 이름, 소개, 카운터, URL이 포함됩니다.

handle, posts, cursor, include

프로필 게시물

1 크레딧

/v1/instagram/profile/posts

공개 프로필 게시물 정보를 반환합니다. 표시 이름, 소개, 카운터, URL이 포함됩니다.

handle, next_max_id, trim

프로필 릴스

1 크레딧

/v1/instagram/profile/reels

공개 프로필 릴스 정보를 반환합니다. 표시 이름, 소개, 카운터, URL이 포함됩니다.

user_id, handle, max_id, trim

게시물

1 크레딧

/v1/instagram/post

공개 게시물 데이터를 반환합니다. 본문, 참여 지표, 작성자 필드가 포함됩니다.

url, region, trim, download_media

게시물 댓글

5 크레딧

/v1/instagram/post/comments

공개 댓글 데이터를 반환합니다. 작성자, 본문, 참여 지표가 포함됩니다.

url, sort, cursor, safe_url

미디어 대본

10 크레딧

/v1/instagram/media/transcript

공개 대본 또는 자막 데이터를 반환합니다. 없으면 환불될 수 있습니다.

url

해시태그 검색

5 크레딧

/v1/instagram/search/hashtag

공개 검색 결과를 반환합니다. 제목, 스니펫 또는 게시물 행이 포함됩니다.

hashtag, type, cursor, safe_url

릴스 검색

1 크레딧

/v1/instagram/search/reels

공개 검색 결과를 반환합니다. 제목, 스니펫 또는 게시물 행이 포함됩니다.

query, date_posted, page

스토리

5 크레딧

/v1/instagram/stories

공개 스토리 데이터를 반환합니다. 본문, 참여 지표, 작성자 필드가 포함됩니다.

handle, user_id, safe_url

Instagram API36개 엔드포인트 지원

문서 보기

Instagram 계정의 공개 프로필을 반환합니다. 소개글과 반올림 없는 정수 팔로워 수(author.followers), 팔로잉 수, 게시물 수, 프로필 사진 URL, 인증 여부가 들어 있습니다.

handle만 있고 계정 정보만 빠르게 훑을 때 사용하세요. 최근 게시물과 계산된 지표까지 함께 받으려면 profile/full입니다.

1크레딧

GET/v1/instagram/profile?handle=instagram

handle

handle · Instagram username without the @ symbol

$ curl https://www.socialcrawl.dev/v1/instagram/profile?handle=instagram \
    -H "x-api-key: sc_YOUR_API_KEY"

대기 중

// 파라미터를 수정한 뒤 "실행해보기"를 누르면 실제 응답을 받습니다

Instagram API 동작 방식

Instagram도 다른 SocialCrawl 소셜 엔드포인트와 같습니다. API 키로 GET /v1/instagram/… 를 호출하고 캐시 미스에 크레딧을 쓰며 동일한 JSON 봉투를 받습니다. 별도 SDK는 없습니다.

호출 인증

x-api-key 헤더에 키를 보냅니다. SocialCrawl 카탈로그 전 구간에 같은 키를 사용합니다.

GET과 쿼리 파라미터

라우트는 GET입니다. handle, url, query, cursor를 쿼리로 전달합니다. 과금 전에 형식을 검증합니다.

크레딧 과금

라이브 미스는 라우트 티어를 차감합니다. 캐시 히트는 0입니다. 빈 응답과 하드 실패는 환불됩니다.

JSON 봉투

응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다.

연동 순서

대부분 제품은 계정을 확인한 뒤 목록을 보고 필요한 게시물만 깊게 읽습니다.

01계정

GET /v1/instagram/profile

Author 형태 프로필입니다.

핸들 또는 id를 한 번 확정합니다.

02목록

GET /v1/instagram/profile/full

최근 공개 항목의 PostList입니다.

라우트가 지원하면 cursor 또는 after로 페이지를 넘깁니다.

03항목

GET /v1/instagram/profile/posts

URL 또는 id 기준 전체 Post입니다.

목록 행만으로 부족할 때 사용합니다.

04댓글

GET /v1/instagram/profile/reels

플랫폼이 제공하는 CommentList입니다.

스레드가 중요할 때만 확장합니다.

요청

GET /v1/instagram/profile
  ?handle=instagram
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here

응답 봉투

{
  "success": true,
  "data": { "/* Author | Post | PostList | CommentList | … */": true },
  "credits_used": 1,
  "credits_remaining": 9999,
  "request_id": "req_…",
  "cached": false
}

data 형태

archetype이 맞으면 필드 이름은 SocialCrawl 나머지 플랫폼과 같습니다.

Authorprofile

id, username, display_name, avatar_url, bio, followers, url, ext

PostList / Postprofile/full

items[].post에 id, url, content, engagement, author, published_at, ext

CommentListprofile/posts

댓글 라우트가 있을 때 items[]에 author, content.text, engagement, published_at

Search / Mediaprofile/reels

검색 결과, 미디어 메타데이터, 대본 등 라우트별 필드

게이트웨이 내부

다른 /v1 플랫폼 엔드포인트와 같은 요청 수명 주기입니다.

엣지 수신

Next.js catch-all이 Hono 소셜 API로 연결됩니다. request_id를 발급하고 키를 인증한 뒤 속도 제한과 동시성을 적용합니다.

검증 후 차감

레지스트리에서 라우트를 찾습니다. 필수 파라미터를 먼저 검사합니다. 잘못된 입력은 미과금 400입니다. 유효 호출은 upstream 전에 차감합니다.

캐시 또는 수집

platform + resource + params로 캐시 키를 만듭니다. 히트는 credits_used 0입니다. 미스는 재시도와 서킷 브레이커로 upstream을 호출합니다.

정규화 후 반환

upstream JSON을 Author / Post / PostList / CommentList(또는 라우트 archetype)로 매핑하고 검증한 뒤 성공 봉투로 감싸 과금 감사 로그를 남깁니다.

운영에서 중요한 과금 규칙

표준 라이브 미스: 티어 비용(보통 1 크레딧)
고급 읽기: 보통 5 크레딧
프리미엄 읽기: 보통 10 크레딧
종량제 라우트: 문서화된 최소 바닥
캐시 히트: 0 크레딧
빈 응답·하드 실패: 자동 환불
잘못된 파라미터: 400, 미과금
크레딧 부족: 402, 미과금
비활성 라우트: 503, 미과금

데이터 수집 방식

Instagram은 SocialCrawl의 공개 읽기 데이터입니다. 공유 스키마로 정규화하므로 별도 OAuth를 배울 필요가 없습니다.

이 API에서의 Instagram

레지스트리에 노출된 공개 Instagram 표면입니다. 연구·모니터링·제품 작업을 위한 읽기 전용입니다.

SocialCrawl 접근 방식

하나의 게이트웨이 뒤에서 소셜 읽기 upstream을 호출합니다. 등록된 두꺼운 라우트는 Prism 컴포지트로 단계를 묶습니다.

엣지에서 나가는 형태

success, data, credits_used, request_id, cached 통일 JSON 봉투입니다. Author / Post / Comment 리프를 공유합니다.

제공하지 않는 범위

쓰기 엔드포인트와 비공개 수신함은 없습니다. 비활성 라우트는 활성 개수에 넣지 않습니다.

필드 매핑

public profile / channel→ author.*프로필 식별자와 카운터

public post / media→ post.* / items[].post게시물 본문과 참여 지표

comment page / tree→ CommentList items[]댓글 또는 검색 결과

이 API의 활용 분야

이 API가 가장 많이 사용되는 작업입니다.

33active Instagram endpoints in the registry

1 / 5 / 10표준·고급·프리미엄 크레딧 단계

크리에이터·브랜드 Instagram 모니터링

호출은 Instagram 프로필, 콘텐츠 목록, 검색, 심화 경로에 집중됩니다. 이 읽기 표면에서는 Instagram Graph 앱 없이 공유 스키마의 공개 Instagram JSON을 제공합니다.

상세 읽기는 캐시 미스 기준 수 초 수준입니다. 검색과 두꺼운 컴포지트는 더 느린 경로입니다.

Instagram API 활용 사례

Instagram 데이터가 가장 많이 쓰이는 작업입니다. 각 항목에서 엔드포인트 순서와 과금 방식을 확인합니다.

소셜 리스닝캠페인과 크리에이터 언급을 위한 해시태그 및 릴스 검색입니다.

댓글 수집커서 페이지네이션으로 게시물 댓글을 조회하며 댓글마다 작성자 정보가 포함됩니다.

크리에이터 분석프로필과 게시물, 릴스를 조회하고 추적 중인 게시물의 시점별 참여 지표를 수집합니다.

인플루언서 검색프로필과 해시태그를 검색하고 상위 게시물의 계정을 해석합니다.

계정 통합 조회팔로워 수와 소개, 게시물을 포함한 공개 프로필 조회입니다. 크리에이터와 브랜드 확인의 가장 일반적인 기준점입니다.

트렌드 감지급상승한 검색어로 해시태그와 릴스를 검색합니다.

영상 자막릴스와 영상 게시물의 텍스트를 계정 목록 조회 이후 항목 단위로 요청합니다.

활용 사례

이 데이터를 활용하는 대표적인 방식과 각 방식에서 주로 사용하는 스택입니다.

모니터링 잡

Python, cron, Slack 봇

Instagram 프로필과 피드를 폴링합니다. 참여 속도가 뛰면 알립니다.

리서치·VoC

Node, 노트북, BI 적재

Instagram에서 검색 후 게시물을 확장해 브랜드·제품·경쟁 언어를 모읍니다.

백엔드 제품 잡

Go, 워커, Explorer

해석-목록-상세를 파이프라인에 연결합니다. 캐시 히트로 반복 비용을 낮춥니다.

두 줄로 호출

라이브 미스는 티어별 크레딧을 사용합니다. 캐시 히트는 무료입니다. 빈 응답과 하드 실패는 환불됩니다.

curl "https://www.socialcrawl.dev/v1/instagram/profile?handle=instagram" \
  -H "x-api-key: sc_your_api_key_here"

curl "https://www.socialcrawl.dev/v1/instagram/profile/full?handle=example" \
  -H "x-api-key: sc_your_api_key_here"

SocialCrawl의 Instagram

카탈로그 전 구간과 같은 키

플랫폼 문서 API 키 받기

엔드포인트

Instagram API는 어떤 데이터를 돌려주나요

모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.

ProfileGet Instagram user profile Profile PostsList Instagram user posts PostGet Instagram post details Post CommentsList Instagram post comments CommentLook up one Instagram comment by URL or id Basic ProfileGet Instagram basic profile Profile ReelsList Instagram user reels HighlightsList Instagram story highlights Highlight DetailGet Instagram highlight detail Search ReelsSearch Instagram reels Media TranscriptGet Instagram media transcript User EmbedGet Instagram user embed HTML Audio ReelsList Instagram reels using an audio track Search HashtagSearch Instagram posts by hashtag Search ProfilesSearch Instagram profiles by keyword Reels TrendingGet trending Instagram reels FollowersList Instagram followers FollowingList Instagram following SimilarList similar Instagram accounts Post LikersList Instagram post likers Post StatsGet Instagram post stats including the share count TaggedList posts an Instagram user is tagged in Location PostsList recent posts at an Instagram location EngagementGet Instagram engagement statistics Search LocationSearch Instagram locations SearchSearch Instagram accounts, hashtags, and places Search PopularSearch popular Instagram posts Post Comment RepliesList replies under an Instagram comment Username SuggestionsGet Instagram username suggestions Search MusicSearch Instagram music StoriesList an Instagram user's active stories Story DownloadDownload a single Instagram story Music TrendingList trending Instagram music Profile FullInstagram profile, recent posts, and computed analytics in one call.Profile Reels FullInstagram reels with views, likes, comments, and per-reel share counts where available, in one call.Profile Posts FullInstagram posts with views, likes, comments, and per-post share counts where available, in one call.

비교

SocialCrawl과 공식 Instagram Graph API, 뭐가 다른가요?

같은 Instagram 데이터를 받는 두 가지 방법을 나란히 비교했어요. 인증부터 비용까지 한눈에 확인해 보세요.

항목	SocialCrawl	공식 Instagram Graph API
인증	x-api-key 헤더 하나면 돼요	Facebook 로그인 OAuth와 페이지 연동 토큰이 필요해요
시작과 심사	가입하고 1분 안에 바로 호출할 수 있어요	Meta 개발자 앱 등록과 앱 심사, 비즈니스 인증까지 거쳐야 해요
요청 한도	앱 단위 쿼터 대신 쓴 만큼 크레딧으로 결제해요	앱·사용자 단위로 호출 한도가 걸려 있어요
데이터 범위	공개 프로필, 게시물, 릴스, 댓글, 하이라이트, 검색까지 받아볼 수 있어요	내가 운영하는 비즈니스·크리에이터 계정 위주예요
응답 스키마	51개 플랫폼이 같은 통합 JSON 스키마를 써요	Graph 노드·엣지 구조예요
요금	요청당 1 크레딧부터, 100 크레딧 무료로 시작해요	호출 한도 안에서는 무료예요
유지보수	Instagram 화면이 바뀌어도 통합 스키마가 그대로 유지돼요	공식 지원이 있고, 내 계정 게시·인사이트 기능은 공식 API가 더 강해요

인증

SocialCrawl

x-api-key 헤더 하나면 돼요

공식 Instagram Graph API

Facebook 로그인 OAuth와 페이지 연동 토큰이 필요해요

시작과 심사

SocialCrawl

가입하고 1분 안에 바로 호출할 수 있어요

공식 Instagram Graph API

Meta 개발자 앱 등록과 앱 심사, 비즈니스 인증까지 거쳐야 해요

요청 한도

SocialCrawl

앱 단위 쿼터 대신 쓴 만큼 크레딧으로 결제해요

공식 Instagram Graph API

앱·사용자 단위로 호출 한도가 걸려 있어요

데이터 범위

SocialCrawl

공개 프로필, 게시물, 릴스, 댓글, 하이라이트, 검색까지 받아볼 수 있어요

공식 Instagram Graph API

내가 운영하는 비즈니스·크리에이터 계정 위주예요

응답 스키마

SocialCrawl

51개 플랫폼이 같은 통합 JSON 스키마를 써요

공식 Instagram Graph API

Graph 노드·엣지 구조예요

요금

SocialCrawl

요청당 1 크레딧부터, 100 크레딧 무료로 시작해요

공식 Instagram Graph API

호출 한도 안에서는 무료예요

유지보수

SocialCrawl

Instagram 화면이 바뀌어도 통합 스키마가 그대로 유지돼요

공식 Instagram Graph API

공식 지원이 있고, 내 계정 게시·인사이트 기능은 공식 API가 더 강해요

자주 묻는 질문

API, 요금제, 기능에 대한 질문과 답변입니다.

문의하기

인스타그램 데이터를 API로 어떻게 가져오나요?

SocialCrawl 인스타그램 API를 쓰시면 돼요. 원하는 엔드포인트(프로필, 게시물, 릴스, 댓글, 자막)를 골라 API 키와 함께 GET 요청을 보내면 구조화된 JSON 응답을 받아볼 수 있어요. 브라우저 자동화나 프록시, 로그인 없이 바로 돼요.

어떤 인스타그램 데이터를 받아올 수 있나요?

프로필(팔로워 수, 바이오, 인증 여부), 게시물 상세(캡션, 좋아요, 미디어 URL), 릴스(조회수, 오디오, 썸네일), 댓글, 스토리 하이라이트, 릴스 자막, 팔로워·팔로잉 목록, 게시물 좋아요 누른 계정, 유사 계정, 스토리, 태그된 게시물, 36개 엔드포인트를 통합 스키마로 받아보실 수 있어요: Profile, Profile Posts, Post, Post Comments, Comment, Basic Profile, Profile Reels, Highlights, Highlight Detail, Search Reels, Media Transcript, User Embed, Audio Reels, Search Hashtag, Search Profiles, Reels Trending, Followers, Following, Similar, Post Likers, Post Stats, Tagged, Location Posts, Engagement, Search Location, Search, Search Popular, Post Comment Replies, Username Suggestions, Search Music, Stories, Story Download, Music Trending, Profile Full, Profile Reels Full, and Profile Posts Full.

인스타그램 API 요금은 어떻게 되나요?

대부분의 엔드포인트는 한 번 요청에 1 크레딧이에요(스탠다드 티어). 릴스 자막과 검색처럼 작업량이 큰 엔드포인트는 조금 더 소진돼요. 새 계정에는 100 크레딧이 무료로 제공돼서 결제 전에 모든 엔드포인트를 테스트해 보실 수 있어요.

인스타그램 데이터를 수집해도 법적으로 괜찮나요?

SocialCrawl은 인스타그램의 공개 콘텐츠만 읽어와요. 로그인 없이 누구나 볼 수 있는 프로필, 게시물, 릴스와 동일한 범위예요. 다만 사용 목적이 인스타그램 약관과 해당 국가의 개인정보 법령에 부합하는지 직접 확인해 주세요. SocialCrawl은 GDPR 정당한 이익에 기반한 문서화된 프레임워크로 운영돼요. 로그인 없이 볼 수 있는 공개 데이터만 다루고, 계정 자격 증명은 일절 사용하지 않으며, 캐시는 2~30분만 유지되고 영구 저장하지 않아요. 자신의 공개 정보에 대한 옵트아웃 채널도 운영해요. 자세한 내용은 socialcrawl.dev/legal/public-data-notice에서 확인하실 수 있어요.

인스타그램 개발자 계정이나 Graph API가 필요한가요?

아니요, SocialCrawl API 키 하나면 충분해요. Meta 개발자 앱 등록이나 권한 신청, 앱 심사 과정 없이 바로 호출하실 수 있어요. 요청만 보내면 정리된 JSON으로 응답이 와요.

Instagram 스크래핑 API는 어떤 걸 쓰는 게 좋아요?

공개 데이터를 읽는 용도라면 SocialCrawl이 잘 맞아요. 프로필, 게시물, 릴스, 댓글, 하이라이트, 팔로워, 게시물 좋아요 누른 계정, 유사 계정, 스토리, 태그된 게시물, 참여율 분석, 리셰어(리그램) 수가 담긴 게시물 통계, 검색, 트렌딩 릴스, 트랜스크립트까지 36개 엔드포인트를 API 키 하나로 호출할 수 있고, 요청당 1 크레딧부터예요. 가입하면 신용카드 없이 100 크레딧을 무료로 받아요. 내 계정 운영과 게시가 목적이라면 공식 Graph API가 맞아요.

Instagram 스크래핑 API와 공식 Instagram API는 뭐가 다른가요?

SocialCrawl은 앱 심사나 승인 대기가 없어요. 가입 직후 x-api-key 하나로 Instagram 엔드포인트를 바로 호출할 수 있고, 응답은 다른 모든 플랫폼과 같은 통합 스키마로 와요. 요금도 플랫폼별 쿼터 대신 크레딧으로 계산해요. 글 게시 같은 쓰기 작업이 필요하다면 공식 API가 맞아요. SocialCrawl은 읽기 전용 데이터만 다뤄요.

AI에게 SocialCrawl을 물어보세요

ChatGPT에 물어보기 Perplexity에 물어보기 Gemini에 물어보기 Claude에 물어보기 Grok에 물어보기

Instagram API 레퍼런스 문서 보기

🤖 AI 에이전트나 LLM이신가요? 이 페이지를 markdown으로 읽어보세요