API

Instagram

Capture and share the world's moments.

Relationship Endpoints

Relationships are expressed using the following terms:

outgoing_status: Your relationship to the user. Can be "follows", "requested", "none".
incoming_status: A user's relationship to you. Can be "followed_by", "requested_by", "blocked_by_you", "none".

  • GET /users/user-id/follows Get the list of users this user follows.
  • GET /users/user-id/followed-by Get the list of users this user is followed by.
  • GET /users/self/requested-by List the users who have requested to follow.
  • GET /users/user-id/relationship Get information about a relationship to another user.
  • POST /users/user-id/relationship Modify the relationship with target user.

GET /users/user-id/follows

  • Response
https://api.instagram.com/v1/users/{user-id}/follows?access_token=ACCESS-TOKEN
{ "data": [{ "username": "kevin", "profile_picture": "http://images.ak.instagram.com/profiles/profile_3_75sq_1325536697.jpg", "full_name": "Kevin Systrom", "id": "3" }, { "username": "instagram", "profile_picture": "http://images.ak.instagram.com/profiles/profile_25025320_75sq_1340929272.jpg", "full_name": "Instagram", "id": "25025320" }] } 

Get the list of users this user follows.

GET /users/user-id/followed-by

  • Response
https://api.instagram.com/v1/users/{user-id}/followed-by?access_token=ACCESS-TOKEN
{ "data": [{ "username": "kevin", "profile_picture": "http://images.ak.instagram.com/profiles/profile_3_75sq_1325536697.jpg", "full_name": "Kevin Systrom", "id": "3" }, { "username": "instagram", "profile_picture": "http://images.ak.instagram.com/profiles/profile_25025320_75sq_1340929272.jpg", "full_name": "Instagram", "id": "25025320" }] } 

Get the list of users this user is followed by.

GET /users/self/requested-by

  • Response
https://api.instagram.com/v1/users/self/requested-by?access_token=ACCESS-TOKEN
{ "meta": { "code": 200 }, "data": [ { "username": "mikeyk", "profile_picture": "http://distillery.s3.amazonaws.com/profiles/profile_4_75sq_1292324747_debug.jpg", "id": "4" } ] } 

List the users who have requested this user's permission to follow.

Parameters
access_token A valid access token.

GET /users/user-id/relationship

  • Response
https://api.instagram.com/v1/users/{user-id}/relationship?access_token=ACCESS-TOKEN
{ "meta": { "code": 200 }, "data": { "outgoing_status": "none", "incoming_status": "requested_by" } } 

Get information about a relationship to another user.

Parameters
access_token A valid access token.

POST /users/user-id/relationship

  • Response
https://api.instagram.com/v1/users/{user-id}/relationship?access_token=ACCESS-TOKEN
{ "meta": { "code": 200 }, "data": { "outgoing_status": "requested" } } 

Modify the relationship between the current user and the target user.

Requirements
Scope: relationships
To request access to this endpoint, please complete this form.
Parameters
access_token A valid access token.
action One of follow/unfollow/block/unblock/approve/ignore.