Brand API Endpoint: Get brand information on users and companies public social media accounts.

Brand API Endpoint

Look up users' or companies' social media public information, such as followers, profiles image, and websites. These users and companies do not need to be a linked Ayrshare user.

If your users have connected their social accounts, user the /analytics endpoint for more detailed information.

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.

Available for Business Plans

Click the in the endpoint to view details.

Get a social account information by a user name.


Available for Facebook, Instagram, LinkedIn, Twitter, and YouTube. For regular analytics see the /analytics endpoint.

Query Parameters




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



Twitter handle URL encoded. For example: "@ayrshare" or "ayrshare".

Required if "twitter" in platforms array.



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.



Facebook Page name URL encoded. For example "@Ayrshare" or "Ayrshare".

Required if "facebook" in platforms array. Facebook personal accounts are not permitted by Facebook.



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.



LinkedIn vanity name such as Linkedin or linkedin-marketing-solutions.





Format: Authorization: Bearer API_KEY See Overview for more information.



Profile Key of a user profile.

    "facebook": {
        "about": "We invite you to wonder. ",
        "description": "Frank Lloyd Wright's architectural masterpiece home to a world-renowned collection of modern and contemporary art.",
        "fanCount": 845048,
        "followersCount": 874337,
        "id": "7640348500",
        "isUnclaimed": false, // whether a Facebook Page that was automatically generated has been claimed by the business it represents.
        "link": "",
        "location": {
            "city": "New York",
            "country": "United States",
            "latitude": 40.782910059774,
            "longitude": -73.959075808525,
            "state": "NY",
            "street": "1071 5th Ave",
            "zip": "10128"
        "name": "Solomon R. Guggenheim Museum",
        "picture": {
            "data": {
                "height": 50,
                "isSilhouette": false,
                "url": "",
                "width": 50
        "username": "guggenheimmuseum",
        "verificationStatus": "blue_verified", // The verification status of the Facebook Page that represents a business, blue_verified or not_verified.
        "website": ""
    "instagram": {
        "biography": "4x Super Bowl Champions #TogetherBlue",
        "followersCount": 2278171,
        "followsCount": 228,
        "id": "17841400118294090", // Instagram Id
        "igId": 261763943,
        "mediaCount": 8965,
        "name": "New York Giants",
        "profilePictureUrl": "",
        "username": "nygiants",
        "website": ""
    "linkedin": {
        "localizedName": "LinkedIn",
        "name": {
            "localized": {
                "it_IT": "LinkedIn",
                "ru_RU": "LinkedIn",
                "pl_PL": "LinkedIn",
                "ro_RO": "LinkedIn",
                "sv_SE": "LinkedIn"
            "preferredLocale": {
                "country": "US",
                "language": "en"
        "id": 1337,
        "vanityName": "linkedin",
        "organizationType": "PUBLIC_COMPANY",
        "locations": [
                "locationType": "HEADQUARTERS",
                "address": {
                    "geographicArea": "CA",
                    "country": "US",
                    "city": "Sunnyvale",
                    "line1": "1000 W Maude",
                    "postalCode": "94085"
                "streetAddressFieldState": "UNSET_OPT_OUT",
                "geoLocation": "urn:li:geo:106316449",
                "staffCountRange": "SIZE_1"
                "locationType": "OTHER",
                "address": {
                    "geographicArea": "Community of Madrid",
                    "country": "ES",
                    "city": "Madrid",
                    "postalCode": "28046"
                "streetAddressFieldState": "OPT_OUT",
                "geoLocation": "urn:li:geo:106809575",
                "staffCountRange": "SIZE_1"
                "locationType": "OTHER",
                "address": {
                    "geographicArea": "ON",
                    "country": "CA",
                    "city": "Toronto",
                    "postalCode": "M5J 2Z2"
                "streetAddressFieldState": "OPT_OUT",
                "geoLocation": "urn:li:geo:108528311",
                "staffCountRange": "SIZE_1"
        "specialties": [
                "locale": {
                    "country": "US",
                    "language": "en"
                "tags": [
                    "Online Professional Network",
                    "People Search",
                    "Company Search",
                    "Address Book",
                    "Professional Identity",
                    "Group Collaboration",
        "website": "",
        "description": "Founded in 2003, LinkedIn connects the world's professionals to make them more productive and successful. With more than 1 billion members worldwide, including executives from every Fortune 500 company, LinkedIn is the world's largest professional network. The company has a diversified business model with revenue coming from Talent Solutions, Marketing Solutions, Sales Solutions and Premium Subscriptions products. Headquartered in Silicon Valley, LinkedIn has offices across the globe..",
        "media": {
            "mediaUrl": "",
            "id": "urn:li:digitalmediaAsset:C560BAQHaVYd13rRz3A",
            "mediaExpiresSeconds": 1723680000000
        "lastUpdated": "2024-05-15T20:42:09.417Z",
        "nextUpdate": "2024-05-15T20:53:09.417Z"
    "twitter": {
        "createdAt": "2017-10-04T15:26:17.000Z",
        "description": "Ayrshare's APIs provide the core infrastructure for social media posting, management, and analytics.",
        "id": "92839209304423",
        "location": "New York, NY",
        "name": "Ayrshare",
        "profileImageUrl": "",
        "publicMetrics": {
            "followersCount": 5361,
            "followingCount": 39,
            "tweetCount": 844,
            "listedCount": 5
        "url": "",
        "username": "Ayrshare"
    "youtube": {
        "created": "2009-05-12T05:28:43Z",
        "description": "",
        "hiddenSubscriberCount": false,
        "isLinked": true,
        "longUploadsStatus": "longUploadsUnspecified",
        "madeForKids": false,
        "playlistId": "UU-0dv2mN6SeXwkEKtfKXJnQ",
        "privacyStatus": "public",
        "subscriberCount": "28200",
        "thumbnailUrl": "",
        "title": "MelissaEtheridgeVEVO",
        "url": "",
        "videoCount": "43",
        "viewCount": "29872467"

Request Examples

curl \
-H "Authorization: Bearer API_KEY" \
-X GET[0]=instagram&platforms[1]=twitter&twitterUser=ayrshare&instagramUser=nygiants

Request Examples

curl \
-H "Authorization: Bearer API_KEY" \

Last updated