Search LinkedIn

Search for LinkedIn companies or people

Available on Business, Enterprise plans.

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

1. For mentions in posts: When implementing @mentions, use this endpoint with typeahead functionality.
2. Company search: Always use the exact vanity name for reliable results.
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

Header Parameters

Authorization · string · required

API Key of the Primary Profile.

Format: Authorization: Bearer API_KEY

Profile-Key · string

Profile Key of a User Profile.

Format: Profile-Key: PROFILE_KEY

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.

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"

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
    }
  ]
}