GET
/
brand
/
byUser
Available on Business, Enterprise plans.

Get public information on social profiles that are not linked. Available for Facebook, Instagram, LinkedIn, Twitter, and YouTube. For detailed analytics on your linked users see the /analytics endpoint.

The account must be public to access the data. Private social accounts are not available.

Location data is only available for business with public locations. Tagging a location in Facebook or Instagram requires an available location.

Header Parameters

Authorization
string
required
Format: Authorization: Bearer API_KEY. See API overview for more information.
Profile-Key
string
Profile Key of a user profile.

Query Parameters

platforms
array
required

String array of platforms: instagram, facebook, linkedin, twitter, or youtube.

twitterUser
string

Twitter handle URL encoded. For example: “@ayrshare” or “ayrshare”. Required if “twitter” in platforms array.

instagramUser
string

Instagram handle URL encoded. For example: “@nygiants” or “nygiants”. Required if “instagram” in platforms array. Note: Only Instagram Business and Creator accounts can be returned.

faceBookUser
string

Facebook Page name URL encoded. For example “@newyorkgiants” or “newyorkgiants”. Required if “facebook” in platforms array. Facebook personal accounts are not permitted by Facebook.

youtubeUser
string

YouTube username URL encoded, channel ID, or playlist ID. Note, channel IDs typically begin with “UC” and playlist IDs begin with “PL”. For example, send the username “MelissaEtheridgeVEVO” or the channel ID as “UCpSUQewzOXg1F0zLmieKCqQ”. Required if “youtube” in platforms array.

linkedinUser
string

LinkedIn vanity name such as Linkedin or linkedin-marketing-solutions. You may also use the LinkedIn person ID retrieved from the history endpoint, i.e. people who liked a post. An example ID: urn:li:person:Z_yXaxh_Et