GETProfiles2 credits

Get following

GET https://api.instagramapi.dev/v1/profile/following

Paginated list of accounts the user follows (~50 per page). Use `cursor` to continue.

Build this with an AI agent

Paste this prompt into Claude, Codex, or any coding agent.

Parameters

Name	Type	Required	Description
handle	string	yes	An Instagram account. Accepts a username (`nike`), a numeric user id (`13460080`), or a full profile URL (`https://instagram.com/nike`). We resolve it automatically.
cursor	string	no	Pagination cursor returned as `next_cursor` in the previous response. Omit for the first page.

Example request

curl "https://api.instagramapi.dev/v1/profile/following?handle=nike" \
  -H "Authorization: Bearer $INSTAGRAMAPI_KEY"

const res = await fetch("https://api.instagramapi.dev/v1/profile/following?handle=nike", {
  headers: { Authorization: `Bearer ${process.env.INSTAGRAMAPI_KEY}` },
});

res = requests.get("https://api.instagramapi.dev/v1/profile/following?handle=nike",
    headers={"Authorization": f"Bearer {INSTAGRAMAPI_KEY}"})

Try it

Live request · uses 2 credits

API key

handle *string

cursorstring

Example responses

Switch tabs to see the body shape for success and each error status.

{
  "data": {
    "items": [
      {
        "id": "51049513",
        "username": "nikebasketball",
        "full_name": "Nike Basketball",
        "is_verified": true,
        "is_private": false,
        "profile_pic_url": "https://instagram.com/.../nike.jpg"
      }
    ],
    "next_cursor": "QVFEZmt..."
  },
  "meta": {
    "endpoint": "profile/following",
    "request_id": "req_3f8a1c9e",
    "credits_charged": 2,
    "credits_remaining": 4987,
    "ms": 412
  }
}

{
  "error": {
    "code": "missing_parameter",
    "message": "Missing required parameter \"handle\".",
    "docs": "/docs/profile/following"
  },
  "meta": {
    "request_id": "req_3f8a1c9e"
  }
}

{
  "error": {
    "code": "invalid_api_key",
    "message": "This API key is invalid or has been revoked.",
    "docs": "/docs#authentication"
  },
  "meta": {
    "request_id": "req_3f8a1c9e"
  }
}

{
  "error": {
    "code": "insufficient_credits",
    "message": "You're out of credits. Top up to continue.",
    "docs": "/dashboard/billing"
  },
  "meta": {
    "request_id": "req_3f8a1c9e"
  }
}

{
  "error": {
    "code": "not_found",
    "message": "No public data for that request (private, deleted, or nonexistent). This is a billed request. We queried Instagram on your behalf.",
    "docs": "/docs/profile/following"
  },
  "meta": {
    "request_id": "req_3f8a1c9e",
    "endpoint": "profile/following",
    "credits_charged": 2,
    "credits_remaining": 4985
  }
}

{
  "error": {
    "code": "upstream_error",
    "message": "Upstream data provider error. You were not charged. Please retry.",
    "docs": "/docs/profile/following"
  },
  "meta": {
    "request_id": "req_3f8a1c9e"
  }
}

Response fields

Fields returned under data on a 200 response. Every response also includes a meta object with billing info.

Field	Type	Description
items	array<object>	The page of accounts this account follows.
items[].id	string	Numeric account id (stable even if the username changes).
items[].username	string	The account's @handle.
items[].full_name	string	Display name shown on the profile (may be empty).
items[].is_verified	boolean	Whether the account has a verified badge.
items[].is_private	boolean	Whether the account is private.
items[].profile_pic_url	string	URL of the account's profile picture.
next_cursor	string	Pass back as `cursor` to fetch the next page; null when there are no more results.

Pagination

List endpoints return up to one page of items plus a next_cursor. To fetch the next page, pass it back as the cursor query parameter. When next_cursor is null, you've reached the end.