Building a Real-time Company Intelligence Engine with Linkup in Lines of Python

Ever tried to research a potential client minutes before a sales call, only to find that your expensive data provider has outdated information? Yeah, me too. That's precisely why I spent last weekend building something different.

The Problem with Static Data ?

Here's a scenario that might sound familiar:

Your sales rep is about to jump on a call with a hot prospect. They quickly look up the company in your fancy data enrichment tool and confidently mention, "I see you recently raised your Series A!" Only to hear an awkward laugh followed by "Actually, that was two years ago. We just closed our Series C last month."

Ouch.

Static databases, no matter how comprehensive, share one fundamental flaw: they're static. By the time information is collected, processed, and made available, it's often already outdated. In the fast-moving world of tech and business, that's a real problem.

A Different Approach ?

What if instead of relying on pre-collected data, we could:

• Get real-time information from across the web
• Structure it exactly how we need it
• Never worry about data freshness again

That's exactly what we're going to build today using Linkup's API. The best part? It's just 50 lines of Python.

Let's Build It! ?

Time to write some code! But don't worry - we'll break it down into bite-sized pieces that even your non-technical coworkers could understand (well, almost ?).

1. Setting Up Our Project ?

First, let's create our project and install the tools we need:

mkdir company-intel
cd company-intel
pip install linkup-sdk pydantic

Nothing fancy here - just creating a new folder and installing our two magical ingredients: linkup-sdk for fetching data and pydantic for making sure our data looks pretty.

2. Defining What We Want to Know ?

Before we start grabbing data, let's define what we actually want to know about companies. Think of this as your wishlist:

# schema.py - Our data wishlist! ?
from pydantic import BaseModel
from typing import List, Optional
from enum import Enum

class CompanyInfo(BaseModel):
    # The basics
    name: str = ""                      # Company name (duh!)
    website: str = ""                   # Where they live on the internet
    description: str = ""                # What they do (hopefully not just buzzwords)

    # The interesting stuff
    latest_funding: str = ""   # Show me the money! ?
    recent_news: List[str] = []         # What's the buzz? ?
    leadership_team: List[str]  = []    # Who's running the show? ?
    tech_stack: List[str] = []         # The tools they love ⚡

This is like telling a restaurant exactly what you want in your sandwich. We're using pydantic to make sure we get exactly what we ordered!

3. The Magic Machine ?✨

Now for the fun part - the engine that makes everything work:

# company_intel.py - Where the magic happens! ?
from linkup import LinkupClient
from schema import CompanyInfo
from typing import List

class CompanyIntelligence:
    def __init__(self, api_key: str):
        # Initialize our crystal ball (aka Linkup client)
        self.client = LinkupClient(api_key=api_key)

    def research_company(self, company_name: str) -> CompanyInfo:
        # Craft our research question
        query = f"""
        Hey Linkup! Tell me everything fresh about {company_name}:

        ? The name of the company, its website, and a short description.
        ? Any recent funding rounds or big announcements?
        ? Who's on the leadership team right now?
        ?️ What tech are they using these days?
        ? What have they been up to lately?

        PS: Only stuff from the last 3 months, please!
        """

        # Ask the question and get structured answers
        response = self.client.search(
            query=query,            # What we want to know
            depth="deep",           # Go deep, not shallow
            output_type="structured",  # Give me clean data
            structured_output_schema=CompanyInfo  # Format it like our wishlist
        )

        return response

Let's break down what's happening here:

1. We create a new CompanyIntelligence class (fancy name, right?)
2. Initialize it with our API key (the key to the kingdom)
3. Define a method that takes a company name and returns all the juicy details
4. Write a friendly query that tells Linkup exactly what we want
5. Get back clean, structured data that matches our wishlist

4. Making It Production-Ready ?

Now let's wrap it in a nice API that your whole team can use:

mkdir company-intel
cd company-intel
pip install linkup-sdk pydantic

What's cool here:

• FastAPI makes our tool available over HTTP (fancy!)
• Simple GET endpoint that anyone can use

5. Let's Take It for a Spin! ?

Time to see our creation in action:

# schema.py - Our data wishlist! ?
from pydantic import BaseModel
from typing import List, Optional
from enum import Enum

class CompanyInfo(BaseModel):
    # The basics
    name: str = ""                      # Company name (duh!)
    website: str = ""                   # Where they live on the internet
    description: str = ""                # What they do (hopefully not just buzzwords)

    # The interesting stuff
    latest_funding: str = ""   # Show me the money! ?
    recent_news: List[str] = []         # What's the buzz? ?
    leadership_team: List[str]  = []    # Who's running the show? ?
    tech_stack: List[str] = []         # The tools they love ⚡

And voilà! Fresh, real-time company data at your fingertips!

6. Fun Extensions ?

Want to make it even cooler? Here are some fun additions you could make:

# company_intel.py - Where the magic happens! ?
from linkup import LinkupClient
from schema import CompanyInfo
from typing import List

class CompanyIntelligence:
    def __init__(self, api_key: str):
        # Initialize our crystal ball (aka Linkup client)
        self.client = LinkupClient(api_key=api_key)

    def research_company(self, company_name: str) -> CompanyInfo:
        # Craft our research question
        query = f"""
        Hey Linkup! Tell me everything fresh about {company_name}:

        ? The name of the company, its website, and a short description.
        ? Any recent funding rounds or big announcements?
        ? Who's on the leadership team right now?
        ?️ What tech are they using these days?
        ? What have they been up to lately?

        PS: Only stuff from the last 3 months, please!
        """

        # Ask the question and get structured answers
        response = self.client.search(
            query=query,            # What we want to know
            depth="deep",           # Go deep, not shallow
            output_type="structured",  # Give me clean data
            structured_output_schema=CompanyInfo  # Format it like our wishlist
        )

        return response

Real World Impact ?

We've been using this in production for our sales team, and it's been a game-changer:

• Pre-call research is always current
• Sales reps are more confident in their outreach
• We catch important company updates as they happen
• Our data actually gets better over time, not worse

Why This Matters ?

1. Always Fresh: Information is gathered in real-time, not pulled from a static database
2. Comprehensive: Combines data from multiple sources across the web
3. Customizable: Structure the data exactly how your team needs it
4. Efficient: Fast enough for real-time lookups before calls
5. Maintainable: Simple code that any developer can understand and modify

Future Ideas ?

The possibilities are endless! Here are some ideas to take it further:

For Sales Teams:

• Slack bot for instant lookups (/research company-name)
• Chrome extension that shows company info on LinkedIn
• Automatic CRM enrichment

For Marketing Teams:

• Track competitor content strategies
• Monitor industry trends
• Identify potential partnership opportunities

For Product Teams:

• Track competitor feature launches
• Monitor customer tech stacks
• Identify integration opportunities

Try It Yourself ?️

Ready to build your own? Here's what you need:

1. Get a Linkup API key
2. Copy the code above
3. Customize the schema for your needs
4. Deploy and enjoy always-fresh company data!

Wrapping Up ?

The days of static databases are numbered. In a world where companies pivot overnight, raise rounds weekly, and change their tech stacks monthly, real-time intelligence isn't just nice to have—it's essential.

What we built here is just the beginning. Imagine combining this with:

• AI for automatic insights
• Trend detection across industries
• Predictive analytics for company growth

Have you built something similar? How do you handle the challenge of keeping company data fresh? Let me know in the comments!

python #api #saas #webdev #buildinpublic

---

Built with ☕ and a healthy obsession with fresh data

The above is the detailed content of Building a Real-time Company Intelligence Engine with Linkup in Lines of Python. For more information, please follow other related articles on the PHP Chinese website!