Instagram 데이터 API

Instagram 데이터 API는 Instagram를 위한 FetchPI의 읽기 인터페이스입니다. 문서화된 REST 엔드포인트가 공개적으로 이용 가능한 Instagram 데이터를 구조화된 JSON으로 반환합니다. 페이지를 파싱하거나 플랫폼 전용 스크레이퍼를 유지하는 대신, 엔드포인트를 호출해 안정적인 필드 이름을 가진 정규화 응답을 읽으면 됩니다. 그 스키마 형태는 모든 FetchPI 플랫폼과 동일합니다. 문서화된 12개 엔드포인트는 모두 케이퍼빌리티 패밀리로 묶여 있고, 각 패밀리에는 참조 페이지·파라미터 표·예시가 있습니다.

API는 위 표에 나열된 Instagram 케이퍼빌리티 패밀리를 다룹니다. 12개 패밀리, 12개 엔드포인트이며 각각 파라미터와 응답 스키마가 문서화되어 있습니다. 대표적인 용도는 프로필 보강, 게시물·댓글 수집, 팔로워 그래프 분석, 키워드 모니터링, 트렌드 추적입니다. 패밀리가 반환하는 정확한 필드는 해당 케이퍼빌리티 페이지에 문서화되어 있고, 계약에 없는 데이터 유형을 API는 약속하지 않습니다.

Instagram에 현재 공개된 케이퍼빌리티 패밀리:

• profile
• user_posts
• post
• comments
• search_posts
• comment_replies
• user_followers
• user_following
• search_users
• stories
• highlights
• post_likers

처음부터 첫 응답까지 세 단계입니다.

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/ig/users/newdev"

모든 엔드포인트는 데이터 API 전체가 공유하는 최신성 파라미터를 받습니다. cache는 업스트림에 접촉하지 않고 저장된 스냅샷으로 답하고, live는 더 최신 데이터를 조회하며 추가 크레딧이 붙을 수 있고, max_age는 허용 가능한 데이터 나이를 초 단위로 제한합니다. 응답의 meta 블록은 각 응답을 만든 모드·데이터 나이·서빙 계층을 보고하므로, 다운스트림 시스템은 최신성을 추측이 아니라 사실로 다룹니다. API가 약속하지 않는 것은 업스트림의 실시간 상태입니다. meta 블록이 실제로 받은 것에 대한 정직한 보고입니다.

직접 만든 Instagram 스크레이퍼는 잘 동작하는 경우의 소유자이기도 합니다. 페이지 구조는 바뀌고, 봇 대책은 강해지고, 파서 수정은 모두 일정에 올라옵니다. 데이터 API는 그 유지 보수를 계약으로 바꿉니다. 문서화된 요청·응답 스키마, 데이터 없음·레이트 리밋 상황의 공개된 오류 코드, 모든 FetchPI 플랫폼에서 재사용되는 하나의 통합 형태입니다. 범위는 양쪽 모두 정직합니다. API는 공개 데이터만 다루고, 계정 자격 증명을 요구하지 않으며, Instagram의 공식 제품이 아닙니다.

홍보 문구가 아니라 통합 과정에서 드러나는 세 가지 이유입니다.

• ▸하나의 정규화 스키마 — Instagram 응답은 모든 FetchPI 플랫폼과 같은 필드 구조를 쓰므로, 멀티 플랫폼 파이프라인은 한 번만 파싱합니다.
• ▸투명한 최신성 — 모든 응답이 최신성 모드·데이터 나이·서빙 계층을 보고합니다. 요청마다 cache 또는 live를 선택하고 그에 맞게 지불합니다.
• ▸사용량 기반 과금 — 공개된 케이퍼빌리티 단가의 요청 단위 크레딧. 좌석 요금도 정액제도 없고, meta 블록이 각 호출의 소비를 보고합니다.

요청 단위로 크레딧 결제됩니다. 케이퍼빌리티별 공개된 단가가 있고, 캐시 응답은 라이브 조회보다 저렴하며, 충전은 셀프서비스입니다. 엔드포인트에는 레이트 리밋이 있어 제한된 호출은 조용히 실패하는 대신 문서화된 RATE_LIMIT_EXCEEDED 오류를 반환하고, 응답의 meta 블록이 소비된 크레딧을 보고합니다. 케이퍼빌리티별 현재 가격은 요금 페이지에, 오류 코드와 레이트 리밋의 전체 참조는 문서에 있습니다.

가격 보기 →