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

# Find LinkedIn Profiles

> A practical guide to quickly locate official LinkedIn home‑page URLs for companies or people

## What we'll build

This tutorial will show you how to find the LinkedIn profile of a company or an individual using Linkup.

* **Input**: Any text prompt that describes the profile you're after (company, school, person, etc.).
* **Process**:
  1. Send the prompt to the [**Search**](/pages/documentation/endpoints/search/overview) endpoint with `depth` set to `"standard"`.
  2. Ask for `outputType` of `"sourcedAnswer"` so we can inspect citations.
  3. Decide whether we're ≥ 99 % sure.
* **Output**: A single LinkedIn URL or `undefined`.

This pattern is perfect for enriching CRMs, onboarding forms, or internal tools where you need fast links with a very low false‑positive rate.

## How to build

<Steps>
  <Step title="Install the SDK">
    <CodeGroup>
      ```python python theme={"system"}
      pip install linkup-sdk
      ```

      ```javascript js theme={"system"}
      npm i linkup-sdk
      ```
    </CodeGroup>
  </Step>

  <Step title="Set Up the Client">
    <CodeGroup>
      ```python python theme={"system"}
      from linkup import LinkupClient

      client = LinkupClient(api_key="<YOUR_LINKUP_API_KEY>")
      ```

      ```javascript js theme={"system"}
      import { LinkupClient } from 'linkup-sdk';

      const client = new LinkupClient({
        apiKey: '<YOUR_LINKUP_API_KEY>',
      });
      ```
    </CodeGroup>

    <Card title="Get your API key" icon="key" href="https://app.linkup.so" horizontal="True">
      Create a Linkup account for free to get your API key.
    </Card>
  </Step>

  <Step title="Make the API Call">
    <CodeGroup>
      ```python python theme={"system"}
      # 🔎  Example
      response = client.search(
          query="Please locate the official LinkedIn page for Linkup (their website is linkup.so).\nReturn only the LinkedIn home‑page URL.\nIf you're not at least 99 % sure the link is accurate, answer with undefined.",
          depth="standard",          # fast yet accurate
          output_type="sourcedAnswer",
          include_images=False,
      )
      print(response.answer)  # either the URL or 'undefined'
      ```

      ```javascript js theme={"system"}
      // 🔎  Example
      const response = await client.search({
        query: `Please locate the official LinkedIn page for Linkup (their website is linkup.so).
        Return only the LinkedIn home‑page URL.
        If you're not at least 99 % sure the link is accurate, answer with undefined.`,
        depth: 'standard', // fast yet accurate
        outputType: 'sourcedAnswer',
        includeImages: false,
      });
      console.log(response.answer); // either the URL or 'undefined'
      ```
    </CodeGroup>
  </Step>

  <Step title="Craft Better Prompts">
    For best accuracy, include **at least two unique signals**:

    | Good signal           | Example                            |
    | --------------------- | ---------------------------------- |
    | Official domain       | "(their website is acme.com)"      |
    | City or region        | "based in Berlin, Germany"         |
    | Stock ticker          | "listed on NASDAQ : ACME"          |
    | Unique slogan/tagline | "company slogan 'Think tangerine'" |

    > **Tip:** Keep the "Return only the LinkedIn home‑page URL…" and the 99 % clause; it gives the model explicit, measurable instructions.
  </Step>

  <Step title="Batch Lookup">
    Need to process a list of companies? Here's a tiny batch helper:

    <CodeGroup>
      ```python python theme={"system"}
      companies = [
          ("Stripe", "stripe.com"),
          ("Intercom", "intercom.com"),
          ("Monzo", "monzo.com"),
      ]

      for name, domain in companies:
          q = (
              f"Locate the official LinkedIn page for {name} (their website is {domain}). "
              "Return only the LinkedIn home‑page URL. If you're not at least 99 % sure, answer with undefined."
          )
          response = client.search(
              query=q,
              depth="standard",
              output_type="sourcedAnswer",
              include_images=False,
          )
          print(name, "→", response.answer)
      ```

      ```javascript js theme={"system"}
      const companies = [
        ['Stripe', 'stripe.com'],
        ['Intercom', 'intercom.com'],
        ['Monzo', 'monzo.com'],
      ];

      for (const [name, domain] of companies) {
        const q = `Locate the official LinkedIn page for ${name} (their website is ${domain}). ` +
                  `Return only the LinkedIn home‑page URL. If you're not at least 99 % sure, answer with undefined.`;
        const response = await client.search({
          query: q,
          depth: 'standard',
          outputType: 'sourcedAnswer',
          includeImages: false,
        });
        console.log(name, '→', response.answer);
      }
      ```
    </CodeGroup>
  </Step>
</Steps>

## Advanced enhancements

* **Faster or deeper search**: try `"fast"` depth first for maximum speed on simple lookups, or fall back to `"deep"` when `"standard"` yields `undefined`.
* **Multiple entities**: adjust the prompt to return an *array* of URLs when searching generic terms like "Acme Inc".
* **Integrate with CRMs**: enrich company records automatically, then store URL + confidence + timestamp.
* **Rate limiting**: use `asyncio` / `Promise.allSettled` with a limiter when batch‑processing thousands.

## Conclusion

With fewer than 20 lines of code you now have a **LinkedIn URL resolver** that's fast, accurate, and configurable. Plug it into sign-up flows, prospecting pipelines, or internal dashboards, and never copy-paste a LinkedIn link again.

<Info>
  **Need help?** Email `support@linkup.so`, ping us on [Discord](https://discord.com/invite/9q9mCYJa86), or [talk to us](https://calendar.app.google/zNUZz7RxgMMk9pKW7).
</Info>