Search LinkedIn

Search for LinkedIn companies or people

GET /brand/search/linkedin

Company Search

curl \
  -H "Authorization: Bearer API_KEY" \
  -X GET "https://api.ayrshare.com/api/brand/search/linkedin?search=ayrshare"

curl \
  -H "Authorization: Bearer API_KEY" \
  -X GET "https://api.ayrshare.com/api/brand/search/linkedin?search=John%20Smith&personOnly=true"

const API_KEY = "API_KEY";

// Search for company or person
fetch("https://api.ayrshare.com/api/brand/search/linkedin?search=ayrshare", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${API_KEY}`
  }
})
  .then((res) => res.json())
  .then((json) => console.log(json))
  .catch(console.error);

// Search for person only
fetch("https://api.ayrshare.com/api/brand/search/linkedin?search=John%20Smith&personOnly=true", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${API_KEY}`
  }
})
  .then((res) => res.json())
  .then((json) => console.log(json))
  .catch(console.error);

import requests

headers = {'Authorization': 'Bearer API_KEY'}

# Search for company or person
r = requests.get('https://api.ayrshare.com/api/brand/search/linkedin?search=ayrshare', headers=headers)
print(r.json())

# Search for person only
r = requests.get('https://api.ayrshare.com/api/brand/search/linkedin?search=john&personOnly=true', headers=headers)
print(r.json())

Company Search Result

{
  "linkedin": [
    {
      "vanityName": "ayrshare",
      "website": "https://www.ayrshare.com",
      "groups": [],
      "description": "Ayrshare's APIs provide the core infrastructure for social media posting, management, and analytics.\n\nThe Ayrshare API takes care of the social media infrastructure so you don't have to. Your team can focus on building your product instead of stitching together and maintaining multiple social media platforms.\n\nPost to Facebook, Twitter, Instagram, LinkedIn, Reddit, Telegram, TikTok, Google My Business, and YouTube.\n",
      "defaultLocale": {
        "country": "US",
        "language": "en"
      },
      "organizationType": "PARTNERSHIP",
      "alternativeNames": [],
      "specialties": [
        "social media",
        "api",
        "saas",
        "social networks",
        "tiktok",
        "facebook",
        "instagram"
      ],
      "staffCountRange": "SIZE_10_TO_100",
      "name": "Ayrshare",
      "primaryOrganizationType": "NONE",
      "locations": [
        {
          "description": {
            "localized": {
              "en_US": "Headquarters"
            },
            "preferredLocale": {
              "country": "US",
              "language": "en"
            }
          },
          "locationType": "HEADQUARTERS",
          "address": {
            "geographicArea": "New York",
            "country": "US",
            "city": "New York",
            "line1": "142 W 57th St",
            "postalCode": "10019"
          },
          "localizedDescription": "Headquarters",
          "streetAddressFieldState": "UNSET_OPT_OUT",
          "geoLocation": "urn:li:geo:103963738"
        }
      ],
      "id": 66755333
    }
  ]
}

{
  "linkedin": [
    {
      "lastName": "Smith",
      "firstName": "John",
      "headline": "CTO at Ayrshare",
      "id": "urn:li:person:WBwF1C23L"
    }
  ]
}

{
  "linkedin": {
    "action": "request",
    "status": "error",
    "code": 101,
    "message": "Missing or incorrect parameters. Please verify with the docs. https://www.ayrshare.com/docs/apis",
    "details": "The search must be a string between 3 and 100 characters."
  }
}

{
  "linkedin": []
}

Search for LinkedIn companies or people based on a search query. This endpoint is commonly used for typeahead mention completion in social media posts.

The linked account must be a LinkedIn company page to search. Personal LinkedIn accounts can not be used to perform searches.

1. For mentions in posts: When implementing @mentions, use this endpoint with typeahead functionality.
2. Company search: The exact company vanity name is required.
3. Person search: Start with at least 3 characters of a name for best results.
4. Rate limiting: This endpoint follows standard API rate limits.

Search Limitations

• Companies: You can search for any LinkedIn company page

• People: You can only search for people who are followers of your LinkedIn account and the Ayrshare linked account must be a LinkedIn company page to perform the search. If a person has their LinkedIn visibility set to private, they will not be found in the search results.

Header Parameters

Query Parameters

search · string · required

Search query to find LinkedIn companies or people.

Requirements:

• Minimum length: 3 characters for people and 1 character for companies.
• Maximum length: 100 characters for both people and companies.

Search behavior:

• For companies: Use the company’s vanity name (found in the LinkedIn URL). Only exact vanity name matches will be returned.

  • Example: For linkedin.com/company/ayrshare, search for “ayrshare”.

  • Searching for partial names like “ayrsh” will NOT return results.

• For people: Use first name and/or last name. Partial name matches are supported.

  • Example: “John Smith” will find people named John Smith. Be sure to URL encode the space.

  • Partial matches like “Joh” or “Smi” will also return results.

  • Remember: Only your LinkedIn followers can be found and the Ayrshare linked account must be a LinkedIn company page to perform the search

personOnly · boolean · default: false

Controls the search scope: - false (default): Searches for companies first, then people if no companies are found. - true: Searches only for people (skips company search entirely).

Examples

Company Search

curl \
  -H "Authorization: Bearer API_KEY" \
  -X GET "https://api.ayrshare.com/api/brand/search/linkedin?search=ayrshare"

curl \
  -H "Authorization: Bearer API_KEY" \
  -X GET "https://api.ayrshare.com/api/brand/search/linkedin?search=John%20Smith&personOnly=true"

const API_KEY = "API_KEY";

// Search for company or person
fetch("https://api.ayrshare.com/api/brand/search/linkedin?search=ayrshare", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${API_KEY}`
  }
})
  .then((res) => res.json())
  .then((json) => console.log(json))
  .catch(console.error);

// Search for person only
fetch("https://api.ayrshare.com/api/brand/search/linkedin?search=John%20Smith&personOnly=true", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${API_KEY}`
  }
})
  .then((res) => res.json())
  .then((json) => console.log(json))
  .catch(console.error);

import requests

headers = {'Authorization': 'Bearer API_KEY'}

# Search for company or person
r = requests.get('https://api.ayrshare.com/api/brand/search/linkedin?search=ayrshare', headers=headers)
print(r.json())

# Search for person only
r = requests.get('https://api.ayrshare.com/api/brand/search/linkedin?search=john&personOnly=true', headers=headers)
print(r.json())

Company Search Result

{
  "linkedin": [
    {
      "vanityName": "ayrshare",
      "website": "https://www.ayrshare.com",
      "groups": [],
      "description": "Ayrshare's APIs provide the core infrastructure for social media posting, management, and analytics.\n\nThe Ayrshare API takes care of the social media infrastructure so you don't have to. Your team can focus on building your product instead of stitching together and maintaining multiple social media platforms.\n\nPost to Facebook, Twitter, Instagram, LinkedIn, Reddit, Telegram, TikTok, Google My Business, and YouTube.\n",
      "defaultLocale": {
        "country": "US",
        "language": "en"
      },
      "organizationType": "PARTNERSHIP",
      "alternativeNames": [],
      "specialties": [
        "social media",
        "api",
        "saas",
        "social networks",
        "tiktok",
        "facebook",
        "instagram"
      ],
      "staffCountRange": "SIZE_10_TO_100",
      "name": "Ayrshare",
      "primaryOrganizationType": "NONE",
      "locations": [
        {
          "description": {
            "localized": {
              "en_US": "Headquarters"
            },
            "preferredLocale": {
              "country": "US",
              "language": "en"
            }
          },
          "locationType": "HEADQUARTERS",
          "address": {
            "geographicArea": "New York",
            "country": "US",
            "city": "New York",
            "line1": "142 W 57th St",
            "postalCode": "10019"
          },
          "localizedDescription": "Headquarters",
          "streetAddressFieldState": "UNSET_OPT_OUT",
          "geoLocation": "urn:li:geo:103963738"
        }
      ],
      "id": 66755333
    }
  ]
}

{
  "linkedin": [
    {
      "lastName": "Smith",
      "firstName": "John",
      "headline": "CTO at Ayrshare",
      "id": "urn:li:person:WBwF1C23L"
    }
  ]
}

{
  "linkedin": {
    "action": "request",
    "status": "error",
    "code": 101,
    "message": "Missing or incorrect parameters. Please verify with the docs. https://www.ayrshare.com/docs/apis",
    "details": "The search must be a string between 3 and 100 characters."
  }
}

{
  "linkedin": []
}