Instagram API
  1. relationships
Instagram API
  • geographies
    • Get recent media from a custom geo-id.
      GET
  • locations
    • Search for a location by geographic coordinate.
      GET
    • Get information about a location.
      GET
    • Get a list of recent media objects from a given location.
      GET
  • media
    • Get a list of currently popular media.
      GET
    • Search for media in a given area.
      GET
    • Get information about a media object.
      GET
    • Get information about a media object.
      GET
  • comments
    • Get a list of recent comments on a media object.
      GET
    • Create a comment on a media object.
      POST
    • Remove a comment.
      DELETE
  • likes
    • Remove a like on this media by the current user.
      DELETE
    • Get a list of users who have liked this media.
      GET
    • Set a like on this media by the current user.
      POST
  • tags
    • Search for tags by name.
      GET
    • Get information about a tag object.
      GET
    • Get a list of recently tagged media.
      GET
  • users
    • Search for a user by name.
      GET
    • See the authenticated user's feed.
      GET
    • See the list of media liked by the authenticated user.
      GET
    • Get basic information about a user.
      GET
    • Get the most recent media published by a user.
      GET
  • relationships
    • List the users who have requested this user's permission to follow.
      GET
    • Get the list of users this user is followed by.
      GET
    • Get the list of users this user follows.
      GET
    • Get information about a relationship to another user.
      GET
    • Modify the relationship between the current user and the target user.
      POST
  1. relationships

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

POST
/users/{user-id}/relationship
relationships
Modify the relationship between the current user and the target user.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.instagram.com/v1/users//relationship?action='
Response Response Example
{
  "data": {
    "outgoing_status": "none"
  },
  "meta": {
    "code": 0
  }
}

Request

Path Params
user-id
string 
required
The ID of the target user.
Query Params
action
string 
required
Type of action to apply for relationship with the user.

Responses

🟢200Relationship information.
application/json
Body
data
object (RelationshipStatus) 
optional
outgoing_status
enum<string> 
optional
Status of outgoing relationship
Allowed values:
nonefollowsrequested
meta
object (MetaData) 
optional
code
integer <int32>
optional
HTTP result code
Modified at 2023-08-15 03:55:31
Previous
Get information about a relationship to another user.
Built with