This tool is part of the Profile Tools category.

​
Parameters

NameTypeRequiredDescription
user_account_idsarray of stringYesArray of user account IDs to retrieve profiles for

​
Example Request

{
  "user_account_ids": ["ua_12345678", "ua_87654321"]
}

​
Example Response

[
  {
    "id": "prof_12345678",
    "user_account_id": "ua_12345678",
    "platform": "YOUTUBE",
    "display_name": "Example Channel",
    "handle": "@examplechannel",
    "biography": "Official channel for Example Corporation, sharing product updates and tutorials.",
    "profile_picture_url": "https://example.com/profile.jpg",
    "cover_image_url": "https://example.com/cover.jpg",
    "external_url": "https://example.com",
    "followers_count": 145000,
    "following_count": 250,
    "posts_count": 387,
    "location": "San Francisco, CA",
    "verified": true,
    "category": "Technology",
    "created_at": "2023-05-20T15:30:00.000Z",
    "updated_at": "2023-06-10T09:45:00.000Z",
    "last_refreshed_at": "2023-06-10T09:45:00.000Z"
  },
  {
    "id": "prof_87654321",
    "user_account_id": "ua_87654321",
    "platform": "INSTAGRAM",
    "display_name": "Example User",
    "handle": "@exampleuser",
    "biography": "Photography enthusiast | Travel lover | Food blogger",
    "profile_picture_url": "https://example.com/insta_profile.jpg",
    "followers_count": 5432,
    "following_count": 876,
    "posts_count": 142,
    "is_business_account": false,
    "is_private": false,
    "created_at": "2023-05-21T10:15:00.000Z",
    "updated_at": "2023-06-11T14:30:00.000Z",
    "last_refreshed_at": "2023-06-11T14:30:00.000Z"
  }
]

​
Usage Notes

  • This method returns profile information for the specified user accounts.
  • The response includes platform-specific profile data that varies by platform.
  • Common fields include display name, biography, profile picture, and follower counts.
  • Platform-specific fields may be included based on what each platform provides.
  • For the latest profile data, consider using Refresh Profile before retrieving profiles.
  • If a user account ID is provided for which no profile exists, it will be omitted from the response.
  • Profile data is cached to minimize API calls to the platforms. Check the last_refreshed_at timestamp to see when the data was last updated.

​
Platform-Specific Fields

Different platforms provide different profile information:
  • YouTube: Subscriber count, total views, channel creation date
  • Instagram: Business account status, private account status, media count
  • TikTok: Follower count, following count, like count, video count
  • Facebook: Page category, page type, verification status
  • LinkedIn: Industry, company size, company type (for company pages)
  • X (Twitter): Follower count, following count, tweet count, verified status