Instagram API
  1. users
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 the list of users this user is followed by.
    • Get the list of users this user follows.
    • Get information about a relationship to another user.
    • Modify the relationship between the current user and the target user.
  1. users

Get basic information about a user.

GET
/users/{user-id}
users
Get basic information about a user. To get information about the owner of the access token, you can use
self instead of the user-id.
Security scope public_content is required to read information about other users.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.instagram.com/v1/users/'
Response Response Example
200 - Example 1
{
  "data": {
    "bio": "string",
    "counts": {
      "followed_by": 0,
      "follows": 0,
      "media": 0
    },
    "full_name": "string",
    "id": "string",
    "profile_picture": "string",
    "username": "string",
    "website": "string"
  },
  "meta": {
    "code": 0
  }
}

Request

Path Params
user-id
string 
required
The ID of a user to get information about, or self to retrieve information about authenticated user.

Responses

🟢200User basic information.
application/json
Body
data
object (UserInfo) 
optional
bio
string 
optional
User biography
counts
object (UserCounts) 
optional
full_name
string 
optional
User full name
id
string 
optional
User ID
profile_picture
string 
optional
URL to user profile picture
username
string 
optional
User name, nickname
website
string 
optional
URL to user web-site
meta
object (MetaData) 
optional
code
integer <int32>
optional
HTTP result code
🟠404Not Found, user with such ID does not exist.
Modified at 2023-08-15 03:55:31
Previous
See the list of media liked by the authenticated user.
Next
Get the most recent media published by a user.
Built with