Get Profiles

Retrieves profile information for one or more user accounts. This tool allows you to get detailed profile data from various platforms, including profile pictures, follower counts, and other platform-specific profile metadata.

This tool is part of the Profile Tools category.

Parameters

Name	Type	Required	Description
user_account_ids	array of string	Yes	Array 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

Related Tools

• Get Profile - Retrieve a specific profile by ID
• Fetch Profile - Fetch the latest profile data from a platform
• Refresh Profile - Refresh profile data from platforms
• Get User Accounts - Get all accounts for a user