> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# LinkedInの検索

> LinkedInの企業または人物を検索する

export const PlansAvailable = ({plans = [], maxPackRequired}) => {
  let displayPlans = plans;
  if (plans && plans.length === 1) {
    const lowerCasePlan = plans[0].toLowerCase();
    if (lowerCasePlan === "business") {
      displayPlans = ["Launch", "Business", "Enterprise"];
    } else if (lowerCasePlan === "premium") {
      displayPlans = ["Premium", "Launch", "Business", "Enterprise"];
    }
  }
  return <Note>
Available on {displayPlans.length === 1 ? "the " : ""}
{displayPlans.join(", ").replace(/\b\w/g, l => l.toUpperCase())}{" "}
{displayPlans.length > 1 ? "plans" : "plan"}.

{maxPackRequired && <span onClick={() => window.open('https://www.ayrshare.com/docs/additional/maxpack', '_self')} className="flex items-center mt-2 cursor-pointer">
 <span className="px-1.5 py-0.5 rounded text-sm" style={{
    backgroundColor: '#C264B6',
    color: 'white',
    fontSize: '12px'
  }}>
   Max Pack required
 </span>
</span>}
</Note>;
};

export const HeaderAPI = ({noProfileKey, profileKeyRequired}) => <>
    <ParamField header="Authorization" type="string" required>
      <a href="/apis/overview#authorization">API Key</a> of the Primary Profile.
      <br />
      <br />
      Format: <code>Authorization: Bearer API_KEY</code>
    </ParamField>
    {!noProfileKey && (profileKeyRequired ? <ParamField header="Profile-Key" type="string" required>
          <a href="/apis/overview#profile-key-format">Profile Key</a> of a User Profile.
          <br />
          <br />
          Format: <code>Profile-Key: PROFILE_KEY</code>
        </ParamField> : <ParamField header="Profile-Key" type="string">
          <a href="/apis/overview#profile-key-format">Profile Key</a> of a User Profile.
          <br />
          <br />
          Format: <code>Profile-Key: PROFILE_KEY</code>
        </ParamField>)}
  </>;

<PlansAvailable plans={["business"]} maxPackRequired={false} />

検索クエリに基づいてLinkedInの企業または人物を検索します。
このエンドポイントは、ソーシャルメディア投稿内のメンション補完（typeahead）でよく使用されます。

**検索するには、リンクされたアカウントがLinkedInの企業ページである必要があります。** 個人のLinkedInアカウントは検索を実行できません。

1. **投稿内のメンション用**: @メンションを実装する際は、このエンドポイントをtypeahead機能とともに使用してください。
2. **企業検索**: 企業の正確なvanity名が必要です。
3. **人物検索**: 最良の結果を得るには、少なくとも3文字の名前で開始してください。
4. **レート制限**: このエンドポイントは標準のAPIレート制限に従います。

<Note>
  **検索の制限**

  <ul class="custom-bullets">
    <li>**企業**: 任意のLinkedIn企業ページを検索できます</li>

    <li>
      **人物**: あなたのLinkedInアカウントのフォロワーである人のみを検索でき、
      検索を実行するには、Ayrshareにリンクされたアカウントが
      LinkedIn企業ページである必要があります。人物がLinkedInの可視性をプライベートに設定している場合、
      検索結果には表示されません。
    </li>
  </ul>
</Note>

## ヘッダーパラメータ

<HeaderAPI />

## クエリパラメータ

<ParamField query="search" type="string" required>
  LinkedInの企業または人物を見つけるための検索クエリ。

  **要件:**

  {" "}

  <ul class="custom-bullets">
    <li>最小長: 人物は3文字、企業は1文字。</li>
    <li>最大長: 人物および企業ともに100文字。</li>
  </ul>

  **検索の動作:**

  <ul class="custom-bullets">
    <li>
      <strong>企業の場合</strong>: 企業のvanity名（LinkedIn URLに含まれる）を使用します。**vanity名が正確に一致する場合のみ**結果が返されます。

      <ul class="custom-bullets">
        <li>
          例: `linkedin.com/company/ayrshare`の場合は"ayrshare"で検索します。
        </li>

        <li>
          "ayrsh"のような部分的な名前で検索しても結果は返されません。
        </li>
      </ul>
    </li>

    <li>
      <strong>人物の場合</strong>: 名または姓、あるいはその両方を使用します。部分的な名前の一致がサポートされます。

      <ul class="custom-bullets">
        <li>
          例: "John Smith"はJohn Smithという名前の人を見つけます。スペースは必ずURLエンコードしてください。
        </li>

        <li>
          "Joh"や"Smi"のような部分一致でも結果が返されます。
        </li>
      </ul>

      <ul class="custom-bullets">
        <li>
          注意: あなたのLinkedInフォロワーのみが検索可能で、Ayrshareにリンクされたアカウントは検索を実行するためにLinkedIn企業ページである必要があります
        </li>
      </ul>
    </li>
  </ul>
</ParamField>

<ParamField query="personOnly" type="boolean" default={false}>
  検索範囲を制御します: - `false`（デフォルト）: 最初に企業を検索し、企業が見つからない場合は人物を検索します。 - `true`: 人物のみを検索します（企業検索を完全にスキップ）。
</ParamField>

## 例

<RequestExample>
  ```bash Company Search theme={"system"}
  curl \
    -H "Authorization: Bearer API_KEY" \
    -X GET "https://api.ayrshare.com/api/brand/search/linkedin?search=ayrshare"
  ```

  ```bash Person Search Only theme={"system"}
  curl \
    -H "Authorization: Bearer API_KEY" \
    -X GET "https://api.ayrshare.com/api/brand/search/linkedin?search=John%20Smith&personOnly=true"
  ```

  ```javascript JavaScript theme={"system"}
  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);
  ```

  ```python Python theme={"system"}
  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())
  ```
</RequestExample>

<ResponseExample>
  ```json Company Search Result theme={"system"}
  {
    "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
      }
    ]
  }
  ```

  ```json Person Search Result theme={"system"}
  {
    "linkedin": [
      {
        "lastName": "Smith",
        "firstName": "John",
        "headline": "CTO at Ayrshare",
        "id": "urn:li:person:WBwF1C23L"
      }
    ]
  }
  ```

  ```json 400: Search query too short theme={"system"}
  {
    "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."
    }
  }
  ```

  ```json 404: No results found theme={"system"}
  {
    "linkedin": []
  }
  ```
</ResponseExample>