Instagram 공개 데이터 API
공개 프로필을 조회하거나 찾고, 팔로워 목록 레코드, 팔로잉 관계, 작성 게시물, 프로필이 태그된 게시물, 해시태그 결과, 릴스, 스크립트, 댓글, 계정 수치, 참여도 지표, 미디어 메타데이터를 하나의 비동기 워크플로로 수집합니다.
사용할 수 있는 Instagram API
알고 있는 프로필 조회, 프로필 탐색, 팔로워 목록 수집, 팔로잉 관계 수집, 계정 지표, 작성 게시물, 프로필이 태그된 게시물, 해시태그 탐색, 릴스, 스크립트, 댓글 중 목적에 맞는 엔드포인트를 고르세요. 모든 엔드포인트가 같은 SocQ 인증 방식과 작업 결과 방식을 사용합니다.

instagram/posts
게시물결과당 0.34 크레딧

instagram/post-info
게시물결과당 0.5 크레딧

instagram/hashtag-posts
검색결과당 0.5 크레딧

instagram/reels-search
검색결과당 0.5 크레딧

instagram/story-highlights
게시물결과당 0.5 크레딧

instagram/tagged-posts
게시물결과당 0.5 크레딧

instagram/transcript
게시물결과당 0.7 크레딧

instagram/audio-reels
게시물결과당 0.5 크레딧

instagram/comments
댓글결과당 0.3 크레딧

instagram/followers-count
프로필결과당 0.52 크레딧

instagram/profiles
프로필결과당 0.6 크레딧

instagram/followers-list
프로필결과당 0.3 크레딧

instagram/following-list
프로필결과당 0.3 크레딧

instagram/reels
게시물결과당 0.52 크레딧

instagram/search
검색결과당 0.54 크레딧

instagram/highlight-items
게시물결과당 0.5 크레딧

instagram/trending-reels
게시물결과당 0.5 크레딧

instagram/stories
게시물결과당 0.5 크레딧

instagram/similar-users
프로필결과당 0.5 크레딧

instagram/comment-replies
댓글결과당 0.3 크레딧

instagram/post-likers
프로필결과당 0.3 크레딧

instagram/location-info
검색요청당 0.5 크레딧

instagram/location-posts
게시물결과당 0.5 크레딧

instagram/location-search
검색요청당 0.5 크레딧

instagram/search-hashtags
검색결과당 0.5 크레딧

instagram/user-about
프로필요청당 0.5 크레딧
어떤 Instagram 데이터를 가져올 수 있나요?
SocQ는 공개 Instagram 결과를 안정적인 JSON 레코드로 정규화하므로, 제품 팀이 브라우저 자동화와 응답 정제 파이프라인을 따로 운영할 필요가 없습니다.
프로필과 탐색
알고 있는 사용자 이름을 조회하거나 공개 계정을 검색해 사용자 이름, 표시 이름, 소개글, 프로필 URL, 프로필 사진, 인증 상태, 공개된 계정 신호를 반환합니다.
팔로워 수와 계정 수치
공개 사용자 이름이나 프로필 URL의 팔로워·팔로잉·게시물 수를 가져옵니다.
공개 팔로워 목록 레코드
원본 사용자 이름별로 공개된 팔로워 프로필을 수집하며, 정규화된 식별 정보, 프로필 이미지, 공개 여부 플래그, 관계 정보, 관측된 위치, 수집 시각이 포함됩니다.
공개 팔로잉 관계
하나 이상의 원본 계정이 팔로우하는 공개 프로필을 수집하며, 식별 정보, 공개 여부, 출처, 관계, 위치, 제공되는 계정 수치 정보가 포함됩니다.
작성 게시물과 태그된 게시물
선택한 사용자 이름이 올린 게시물이나 선택한 프로필을 태그한 게시물을 수집하며, 캡션, 작성자, 미디어, 태그 정보, 타임스탬프, 공개된 참여도가 포함됩니다.
해시태그 게시물 탐색
하나 이상의 해시태그에 해당하는 공개 게시물을 찾으며, 기간과 릴스 필터를 선택할 수 있고 일치한 해시태그 정보도 함께 제공됩니다.
공개 릴스
제공되는 경우 릴스 캡션, 미디어 참조, 재생·참여도 수치, 길이, 해시태그, 멘션, 오디오 메타데이터를 수집합니다.
게시물·릴스 스크립트
공개 게시물이나 릴스 URL에서 스크립트 텍스트, 언어, 형식, 출처 정보를 추출합니다. 음성이 없는 미디어는 레코드가 반환되지 않을 수 있습니다.
공개 댓글
공개 Instagram 게시물 URL에서 댓글 텍스트, 작성자 필드, 타임스탬프, 게시물 참조, 공개된 좋아요·답글 수를 수집합니다.
SocQ vs Instagram Graph API
두 제품은 해결하는 연동 과제가 다릅니다. SocQ는 정규화된 공개 데이터 수집을 위해 설계되었고, Meta의 공식 API는 주로 권한이 부여된 프로페셔널 계정과 플랫폼 작업을 위해 설계되었습니다.
| 기능 | SocQ | Instagram Graph API |
|---|---|---|
| 주요 용도 | 공개 프로필, 팔로워 목록, 팔로잉 관계, 콘텐츠, 댓글 데이터 수집 | 권한이 부여된 비즈니스·크리에이터 계정 관리 |
| 고객 OAuth | SocQ API 키만 사용하며 고객의 Instagram OAuth 불필요 | Meta 앱 설정과 계정 권한 부여 |
| 게시 | 지원하지 않음 | 해당 프로페셔널 계정에서 지원 |
| 비공개 콘텐츠 | 지원하지 않음 | 권한을 부여받은 데이터만 가능 |
| 응답 형식 | SocQ 엔드포인트 전반에서 정규화 | Meta Graph 고유 응답 구조 |
Instagram API 작동 방식
모든 Instagram 엔드포인트가 같은 비동기 워크플로를 따르므로, 오래 걸리는 수집이 요청 스레드를 붙잡지 않습니다.
1. 작업 제출
검색어, 사용자 이름, 해시태그, 공개 프로필·콘텐츠 URL과 선택적 결과 상한을 담아 POST 요청을 보냅니다.
2. 작업 상태 폴링
반환된 작업 ID로 작업이 성공하거나 실패할 때까지 확인합니다. 짧은 간격으로 재시도를 반복하지 말고 간격을 늘려 가며 다시 시도하세요.
3. 정규화된 결과 읽기
결과 항목을 가져와 안정적인 ID를 저장하고, 레코드가 더 있으면 next_cursor를 따라갑니다.
SocQ API 키로 인증합니다. 이 예시는 공개 Instagram 프로필 검색을 시작합니다. 알고 있는 프로필 조회, 팔로워 목록, 팔로잉 관계, 작성 게시물·태그된 게시물, 해시태그 탐색, 릴스, 스크립트, 댓글, 계정 수치도 같은 작업 흐름을 사용합니다.
curl -X POST "https://api.socq.ai/v1/instagram/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"sustainable travel","results_limit":25}'
# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50Instagram API 주요 활용 사례
크리에이터 탐색
관련 공개 프로필을 찾은 뒤, 선택한 계정에 게시물, 릴스, 공개된 팔로워 지표를 더해 정보를 보강합니다.
팔로워 목록 리서치
공개된 팔로워 프로필을 샘플로 수집하고, 선택한 원본 계정 간 중복을 비교하며, 고른 사용자 이름을 프로필 정보 보강 대기열에 넣습니다.
콘텐츠 모니터링
캠페인, 경쟁사, 크리에이터, 반복되는 콘텐츠 형식을 대상으로 작성 게시물, 선택한 프로필이 태그된 게시물, 해시태그 결과, 릴스, 스크립트 레코드, 선택한 공개 댓글을 추적합니다.
분석 데이터 보강
공개된 소셜 식별 정보와 참여도 필드를 내부 대시보드, 데이터 웨어하우스, 리포팅 시스템에 추가합니다.
리서치 디렉터리
안정적인 URL, ID, 수집 타임스탬프를 갖춘 검토 가능한 공개 계정·콘텐츠 데이터셋을 구축합니다.
제한 사항과 공개 데이터 정책
SocQ는 공개된 Instagram 결과만 다룹니다. 계정, 콘텐츠, 공개 원본의 응답이 바뀌면 제공 여부도 달라질 수 있습니다.
- 비공개 콘텐츠, 접근이 제한된 콘텐츠, 삭제된 콘텐츠, 로그인해야만 볼 수 있는 콘텐츠는 지원 범위에 포함되지 않습니다.
- 팔로워 목록 결과는 전체 내보내기가 아니라 공개된 샘플이며, 같은 프로필이 제출한 여러 원본 계정에서 중복으로 나타날 수 있습니다.
- 일부 공개 레코드에는 카운터, 댓글 필드, 미디어 참조, 소개글, 오디오 필드가 없을 수 있습니다.
- 요청 속도는 보수적으로 유지하고, 커서 페이지네이션을 사용하며, 속도 제한 응답을 받으면 간격을 늘려 다시 시도하세요.
- 이 API로 Instagram 콘텐츠를 게시·수정·삭제하지 마세요.
Instagram API 자주 묻는 질문
공식 Instagram Graph API인가요?
아니요. SocQ는 지원하는 공개 Instagram 결과를 정규화해 제공합니다. 권한이 부여된 계정 관리나 게시가 필요하면 Meta의 Graph API를 사용하세요.
사용자가 Instagram 계정을 연결해야 하나요?
지원하는 공개 데이터 엔드포인트에는 고객의 Instagram OAuth가 필요하지 않습니다. 요청은 SocQ API 키를 사용합니다.
비공개 프로필에 접근할 수 있나요?
아니요. 비공개 콘텐츠, 접근이 제한된 콘텐츠, 로그인해야만 볼 수 있는 Instagram 콘텐츠는 지원하지 않습니다.
요금은 어떻게 부과되나요?
각 엔드포인트에 현재 결과 1건당 크레딧 요금이 표시됩니다. 작업이 반환한 정규화된 결과 레코드를 기준으로 과금됩니다.
여러 플랫폼의 데이터를 결합해 더 폭넓은 비즈니스 인사이트를 얻으세요
여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.
TikTok API
지원하는 공개 TikTok 프로필, 개별 동영상 메타데이터, 최상위 댓글, 동영상 검색 결과, 지정한 해시태그의 동영상을 하나의 정규화된 비동기 워크플로로 수집합니다.
YouTube API
지원되는 공개 YouTube 채널 프로필, 동영상 상세 정보, 채널 동영상, 댓글, 쇼츠, 키워드·해시태그 결과, 제공되는 스크립트를 하나의 정규화된 비동기 워크플로로 수집합니다.
Facebook API
공개 Facebook 페이지 프로필, 게시물, 그룹 게시물, 댓글, 키워드에 일치하는 이벤트, 가져올 수 있는 동영상 스크립트를 수집합니다. 식별 정보, 콘텐츠, 출처, 형식, 장소, 미디어, 반응, 참석, 참여도 필드는 정규화되어 제공됩니다.
X API
공개 프로필, 팔로워·팔로잉 관계, 게시물, 답글, 인용, 리포스트한 사용자, 검색 결과, 현재 트렌드를 수집합니다. 일관된 결과를 리서치와 모니터링에 활용하세요.
LinkedIn API
알고 있는 URL에서 공개 LinkedIn 프로필, 기업, 게시물, 채용 공고 데이터를 가져옵니다. 식별 정보, 경력, 기업, 콘텐츠, 참여도, 채용 공고 필드가 정규화되어 제공됩니다.
Reddit API
알고 있는 URL에서 공개 Reddit 게시물과 댓글을 가져오고, 서브레딧의 새 글·인기 글·핫 게시물을 둘러보거나, 키워드와 게시 기간으로 토론을 검색합니다.