Instagram user_following API

REST 호출 한 번으로 Instagram user_following 데이터를 조회 — 모든 플랫폼이 공유하는 안정적인 JSON 스키마로 정규화됩니다.

게시된 엔드포인트 1개
GET /v1/ig/users/{username}/following

계약 요약(영어): List following (capability ig.user_following)

정규화된 응답 엔터티: instagram/user_following
capability: ig.user_following

모든 응답에는 신선도(cache / default / live)와 과금 메타데이터도 포함됩니다.

활용 사례

{{platform}} 계정의 오디언스 분석: 정규화·페이지네이션된 JSON으로 팔로워·팔로잉 목록을 조회.
계정 간 공통 팔로워를 찾아 오디언스 관계를 파악하고 상호작용 그룹을 탐지.
제휴 전 오디언스 품질과 중복도를 평가 — 원본 페이지 내보내기가 필요 없습니다.

응답 필드

instagram user_following response (normalized envelope)

Paginated accounts a user follows as normalized user entities (capability ig.user_following). Page size follows the request's `limit` parameter (1..100, default 20). Envelope of GET /v1/ig/users/{username}/following.

필드	타입	필수	설명
data	profile[]	필수	—
next_cursor	string \| null	필수	Opaque pagination cursor; null when the list is exhausted.
meta.request_id	string	필수	—
meta.freshness.mode	cache \| default \| live	필수	—
meta.freshness.age_seconds	integer \| null	선택	—
meta.freshness.source_layer	cache \| db \| upstream	필수	—
meta.freshness.stale	boolean	선택	—
meta.billing.cache_hit	boolean	필수	—
meta.billing.amount_credits	integer	필수	Credits actually charged for this request (the settlement unit; 1 credit = $0.0001, permanent).

필드 비고는 계약 영문 원문으로 표시됩니다.

응답 메타데이터

필드	타입	필수	설명
mode	cache \| default \| live	필수	Effective mode after merging param > max_age > source policy (D-004).
age_seconds	integer \| null	선택	Age of served data; null when unknown.
source_layer	cache \| db \| upstream	필수	Which layer served the response (PRD §10).
stale	boolean	선택	True when stale data was served under stale_if_error / SWR (D-004).
billing.amount_credits	integer	필수	Micro-USD (1e-6 USD) actually charged for this request.
billing.cache_hit	boolean	필수	—

필드 비고는 계약 영문 원문으로 표시됩니다.

요청·응답 예시

GET/v1/ig/users/{username}/following

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

{
  "data": [
    {
      "id": "1295448945",
      "platform": "instagram",
      "type": "profile",
      "username": "creatordev",
      "display_name": "Creator Dev",
      "description": "Photo dumps and API graphs.",
      "url": "https://fetchpi.com",
      "profile_image_url": "https://cdn.example.com/profile_pic/creatordev.jpg",
      "verified": true,
      "is_private": false,
      "created_at": null,
      "metrics": {
        "followers": 51230,
        "following": 310,
        "posts": 862
      },
      "fetched_at": "2026-09-18T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

무료 데모

무료 계정을 만들고 API 키를 발급받으면 브라우저 Playground에서 바로 호출할 수 있습니다.

Playground에서 사용해 보기

이 엔드포인트의 파라미터 표, 오류 코드, 응답 의미는 API 문서에 있습니다.

엔드포인트 레퍼런스 열기

자주 묻는 질문

긴 팔로워 목록은 어떻게 처리되나요?

목록은 커서 페이지네이션으로 제공됩니다 — 반환된 cursor로 다음 페이지를 요청해 필요한 만큼 가져오면 됩니다.

이 엔드포인트를 무료로 써볼 수 있나요?

네 — 계정을 등록하고 API 키를 발급받으면 콘솔의 Playground에서 호출할 수 있습니다.

user_following 능력은 어떻게 과금되나요?

Data API는 요청 단위 크레딧 과금이며 cache/live 신선도에 따라 배율이 다릅니다. 현재 능력별 가격은 가격 페이지를 기준으로 합니다.

가격

요청 단위 크레딧 과금, cache/live 신선도 옵션 — 최신 가격은 가격 페이지 기준입니다.

가격 보기 모든 API 둘러보기