Skip to main content

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.

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

1

Install the SDK

pip install linkup-sdk
2

Set Up the Client

from linkup import LinkupClient

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

Get your API key

Create a Linkup account for free to get your API key.
3

Make the API Call

# 🔎  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'
4

Craft Better Prompts

For best accuracy, include at least two unique signals:
Good signalExample
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.
5

Batch Lookup

Need to process a list of companies? Here’s a tiny batch helper:
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)

​
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.
Need help? Email support@linkup.so, ping us on Discord, or talk to us.