Comment
Author: Admin | 2025-04-28
The User Profile API allows your app to get an Instagram user's profile information using the user's Instagram-scoped ID received from an Instagram messaging webhook notification. Your app can use this information to create a personalized messaging experience for Instagram users who are interacting with your app users.User ConsentUser consent is required to access an Instagram user's profile.User consent is set only when an Instagram user sends a message to your app user, or clicks an icebreaker or persistent menu. If an Instagram user comments on a post or comment but has not sent a message to your app user, and your app tries to send the Instagram user a message, your app will receive an error, User consent is required to access user profile.RequirementsThis guide assumes you have read the Instagram Platform Overview and implemented the needed components for using this API, such as a Meta login flow and a webhooks server to receive notifications.You will need the following:Access LevelAdvanced Access if your app serves Instagram professional accounts you don't own or manageStandard Access if your app serves Instagram professional accounts you own or manage and have added to your app in the App DashboardAccess tokensAn Instagram user access token requested from your app user who received the webhook notification and who can manage messages on the Instagram professional accountBase URLAll endpoints can be accessed via the graph.instagram.com host.Endpoints/IDsThe Instagram-scoped ID () for the Instagram user interested in your app user; received from a webhook notificationPermissionsinstagram_business_basic instagram_business_manage_messagesWebhook event subscriptionsmessagesmessaging_optinsmessaging_postbacksmessaging_referralLimitationsIf the Instagram user has blocked your app user, your app will not be able to view the Instagram user's information.Webhook notificationIn order to get profile information for an Instagram user who has messaged your app user's Instagram professional account, you need the Instagram-scoped ID for the Instagram user that was sent in a message notification, the value of the messages.sender.id property.{ "object": "instagram", "entry": [ { "id": "", // Your app user's Instagram Professional account ID "time": , "messaging": [ { "sender": { "id": "" }, // Instagram-scoped ID for the Instagram user who sent the message... Get profile informationTo get an the Instagram user's profile information, send a GET request to the / endpoint, where is the Instagram-scoped ID received in a messaging webhook notification, with the fields parameter set to a comma separated list of information you would like to view.Sample RequestFormatted for readability.curl -X GET "https://graph.instagram.com/v22.0/ \ ?fields=name,username,profile_pic,follower_count,is_user_follow_business,is_business_follow_user \ &access_token="On success, your app will receive the following JSON response:{ "name": "Peter Chang", "username": "peter_chang_live", "profile_pic": "https://fbcdn-profile-...", "follower_count": 1234 "is_user_follow_business": false, "is_business_follow_user": true,}Reference Field Name Description access_tokenstringThe Instagram user access token from your app user who can manage messages on the Instagram professional account who received the webhook notificationfollower_countintThe number of followers the Instagram user hasintThe Instagram-scoped ID returned in a webhook notification that represents the Instagram user who interacted with your app user's Instagram professional account and triggered the notificationis_business_follow_userbooleanIndicates whether your app user follows the Instagram user (true) or not (false)is_user_follow_businessbooleanIndicates whether the Instagram user follows
Add Comment