> ## 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 بناءً على استعلام بحث.
تُستخدم نقطة النهاية هذه عادةً في إكمال الإشارات (@mentions) عبر الاقتراح الفوري ضمن منشورات وسائل التواصل الاجتماعي.

**يجب أن يكون الحساب المرتبط صفحة شركة على LinkedIn لإجراء البحث.** لا يمكن استخدام حسابات LinkedIn الشخصية لإجراء عمليات البحث.

1. **للإشارات في المنشورات**: عند تنفيذ الإشارات (@mentions)، استخدم نقطة النهاية هذه مع وظيفة الاقتراح الفوري.
2. **البحث عن الشركات**: يُشترط الاسم المخصص (vanity name) الدقيق للشركة.
3. **البحث عن الأشخاص**: ابدأ بـ 3 أحرف على الأقل من الاسم للحصول على أفضل النتائج.
4. **حدود المعدل**: تتبع نقطة النهاية هذه حدود معدلات الاستدعاء القياسية لواجهة API.

<Note>
  **قيود البحث**

  <ul class="custom-bullets">
    <li>**الشركات**: يمكنك البحث عن أي صفحة شركة على LinkedIn.</li>

    <li>
      **الأشخاص**: يمكنك البحث فقط عن الأشخاص المتابعين لحسابك على LinkedIn، ويجب أن يكون
      حساب Ayrshare المرتبط صفحة شركة على LinkedIn لإجراء البحث. إذا كان الشخص قد ضبط
      ظهوره على LinkedIn إلى خاص، فلن يظهر في نتائج البحث.
    </li>
  </ul>
</Note>

## معاملات الرأس (Header)

<HeaderAPI />

## معاملات الاستعلام (Query)

<ParamField query="search" type="string" required>
  استعلام البحث للعثور على شركات أو أشخاص في LinkedIn.

  **المتطلبات:**

  {" "}

  <ul class="custom-bullets">
    <li>الحد الأدنى للطول: 3 أحرف للأشخاص وحرف واحد للشركات.</li>
    <li>الحد الأقصى للطول: 100 حرف لكل من الأشخاص والشركات.</li>
  </ul>

  **سلوك البحث:**

  <ul class="custom-bullets">
    <li>
      <strong>للشركات</strong>: استخدم الاسم المخصص للشركة (vanity name) الموجود في عنوان LinkedIn URL. تُرجع **المطابقات الدقيقة للاسم المخصص** فقط.

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