GET
/
brand
/
byUser

Get information on any public 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

Query Parameters

platforms
array
required

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

blueskyUser
string

Bluesky handle URL encoded. For example: “@ayrshare” or “ayrshare”.

Required if “bluesky” in platforms array.

facebookUser
string

Facebook Page name URL encoded. For example “@newyorkgiants” or “newyorkgiants”. Facebook personal accounts are not permitted by Facebook.

Required if “facebook” in platforms array.

instagramUser
string

Instagram handle URL encoded. For example: “@nygiants” or “nygiants”. Note: Only Instagram Business and Creator accounts can be returned.

Required if “instagram” in platforms array.

linkedinUser
string

LinkedIn company (organization) vanity name such as Linkedin or linkedin-marketing-solutions.

You can also look up a person using their LinkedIn person ID retrieved from the history endpoint, i.e. people who liked a post. An example ID: urn:li:person:Z_yXaxh_Et

Required if “linkedin” in platforms array.

twitterUser
string

Twitter handle URL encoded. For example: “@ayrshare” or “ayrshare”.

Required if “twitter” in platforms array.

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”.

You may also use the YouTube handle found in the YouTube URL. For example, the handle for https://www.youtube.com/@mkbhd is “@mkbhd”. Be sure to keep the @ symbol to designate the handle.

Required if “youtube” in platforms array.