Back to Use Cases
Linkup

How to search for news with Linkup

Track competitors, research markets, monitor regulatory changes, and stay informed with Linkup's powerful news search capabilities.

Overview

News search is one of Linkup's most versatile capabilities. Whether you're tracking competitors, researching markets, or staying informed on regulatory changes, Linkup can find, filter, and structure news content from across the web.

Why Linkup for news search?

Date filtering

fromDate and toDate let you target specific time windows

structuredOutput

Returns news in consistent formats for dashboards and alerts

Agentic search

Synthesize across multiple sources and find patterns

Deep search

Follow up on stories by scraping full articles for details

Configuration

Recommended settings for news search

ParameterValueWhy
depthstandard or deepStandard for monitoring; deep for investigative research
outputTypestructuredOutputConsistent format for automation and dashboards
fromDate / toDatebased on needsEssential for filtering to relevant time periods
includeDomainsoptionalRestrict to trusted news sources
excludeDomainsoptionalFilter out low-quality or irrelevant sources

Use Cases

Practical examples with prompts and schemas

1

Industry & Market News

Stay informed on trends, regulations, and developments in your industry. You can search for one or multiple topics.

Prompt- industry-market-news
You are a market intelligence analyst searching for industry news.

Industry: {industry}
Key Words to monitor: {words}
Geographic focus: {regions}

Search for recent news covering:
- Market trends and forecasts
- Regulatory changes and policy updates
- Major deals (M&A, partnerships, funding rounds)
- New product or technology announcements
- Industry challenges or disruptions
- Expert analysis and commentary

Prioritize:
1. Tier-1 business publications (WSJ, Bloomberg, Reuters, Financial Times)
2. Industry-specific trade publications
3. Regional business journals for {regions}

Exclude opinion pieces without factual news content.
2

Company Specific Monitoring

Track news mentions for your company, competitors, or portfolio companies.

Prompt- company-monitoring
You are a media monitoring analyst tracking news about a specific company.

Company: {company_name}
Also known as: {aliases}
Key executives to track: {executive_names}

Search for recent news articles mentioning {company_name} including:
- Company announcements and press releases
- Product launches or updates
- Funding, M&A, or financial news
- Executive changes or quotes
- Industry analysis mentioning the company
- Any controversies or negative coverage

For each article found, extract the headline, publication, date, and a brief summary of why the company was mentioned. Don't use the same article more than once.

Exclude job postings, event listings, and stock ticker mentions without substance.
3

Event-Triggered News Search

Search for news about a specific event, announcement, or development.

Prompt- event-triggered
You are a research analyst investigating a specific news event.

Event: {event_description}
Date of event: {event_date}
Key entities involved: {entities}

Search for comprehensive coverage of this event:

1. Find the original breaking news or announcement source—identify who reported it first.

2. Search for follow-up coverage and analysis from major publications. For each article:
   - Scrape the full article to understand the angle and new information added
   - Write a one-line brief (under 20 words) summarizing what this article contributes to the story

3. Search for reactions and commentary from:
   - Industry analysts and market commentators
   - Affected parties (companies, individuals, organizations mentioned)
   - Subject matter experts in relevant fields
   - Social media and public figures

4. Search for any contradictory reports, corrections, updates, or retractions.

5. Compile a timeline of how the story developed, noting when new information emerged.

Do not stop until you have found the original source and at least 4 to 8 pieces of follow-up coverage.
4

Competitive Intelligence News

Monitor competitor activities and market positioning.

Prompt- competitive-intel
You are a competitive intelligence analyst tracking competitor news.

Competitors to monitor:
{competitor_list}

For each competitor, search for recent news about:
- Product launches or updates
- Pricing changes or promotions
- Strategic partnerships or integrations
- Funding rounds or financial performance
- Leadership changes
- Customer wins or case studies
- Expansion into new markets or segments

Also search for comparative articles that mention multiple competitors or industry rankings.

Organize findings by competitor, then by topic.
5

Executive & People News

Track news about specific individuals—executives, investors, board members.

Prompt- executive-news
You are a research analyst tracking news about key individuals.

Person: {person_name}
Current role: {current_role}
Company: {company}
Previous roles (if relevant): {previous_roles}

Search for recent news mentioning {person_name}:
- Quotes or interviews given
- Speaking engagements or conference appearances
- Board appointments or advisory roles
- Published articles or thought leadership
- Personal news (awards, appointments, departures)
- Mentions in company news

Exclude routine mentions (e.g., standard bylines, boilerplate leadership bios).

Best Practices

Tips for getting the best results

Do's

  • 1Use date filters — News without time bounds might return outdated content
  • 2Include company aliases and ticker symbols — "Meta" vs "Facebook" vs "META" can yield different results
  • 3Use includeDomains for quality control — Restrict to trusted publications when accuracy matters
  • 4Request sentiment classification — Useful for monitoring and alerting workflows
  • 5Ask for "key takeaway" summaries — More useful than full article text for digests
  • 6Use deep for investigative research — When you need to follow threads across sources
x

Don'ts

  • 1Don't search for overly broad terms — "Technology news" is too vague; be specific
  • 2Don't forget to exclude noise — Job postings, event listings, and stock tickers without context

Working with Date Filters

Date filtering is critical for news search

NeedParameters
Last 24 hoursfromDate: "{yesterday}"
Last 7 daysfromDate: "{7_days_ago}"
Last 30 daysfromDate: "{30_days_ago}"
Specific weekfromDate: "{week_start}", toDate: "{week_end}"
Since last checkfromDate: "{last_run_timestamp}"
Historical researchfromDate: "{start}", toDate: "{end}"
Pro Tip
Use ISO 8601 format (YYYY-MM-DD) for dates. For monitoring, store your last successful run timestamp and use it as fromDate. For event research, start with a narrow window around the event, then expand if needed.

Source Quality Tiers (Examples)

Consider restricting to quality sources for critical use cases

Tier 1 — Major Business Publications
{
  "includeDomains": [
    "reuters.com",
    "bloomberg.com",
    "wsj.com",
    "ft.com",
    "nytimes.com",
    "economist.com"
  ]
}
json
Tier 2 — Tech & Startup Coverage
{
  "includeDomains": [
    "techcrunch.com",
    "theverge.com",
    "wired.com",
    "arstechnica.com",
    "venturebeat.com"
  ]
}
json
Tier 3 — Industry Trade Publications (Healthcare Example)
{
  "includeDomains": [
    "statnews.com",
    "fiercehealthcare.com",
    "healthcaredive.com",
    "modernhealthcare.com"
  ]
}
json
Sources to Consider Excluding
{
  "excludeDomains": [
    "pinterest.com",
    "facebook.com",
    "linkedin.com"
  ]
}
json

Integration Patterns

How to integrate news search into your workflow

Daily News Monitoring

Automated daily news digests

  1. 1.Schedule daily job (e.g., 6 AM)
  2. 2.Set fromDate = yesterday, toDate = today
  3. 3.Call Linkup for each monitored entity/topic
  4. 4.Deduplicate across queries
  5. 5.Score/rank by relevance and sentiment
  6. 6.Deliver via email, Slack, or dashboard

Real-Time Alerting

Immediate notifications for important news

  1. 1.Run frequent checks (hourly or more)
  2. 2.Set fromDate = last_check_timestamp
  3. 3.Filter for high-priority signals (negative sentiment, specific keywords)
  4. 4.Trigger immediate alerts for matches
  5. 5.Update last_check_timestamp

Weekly Digest Generation

Comprehensive weekly briefings

  1. 1.Schedule weekly job
  2. 2.Set fromDate = 7 days ago
  3. 3.Use deep search for comprehensive coverage
  4. 4.Generate executive briefing format
  5. 5.Include trend analysis across the week
  6. 6.Deliver as formatted report

Research Projects

In-depth research and analysis

  1. 1.Define research question and entities
  2. 2.Set appropriate date range
  3. 3.Use deep search with follow-up instructions
  4. 4.Aggregate and deduplicate sources
  5. 5.Extract key facts and quotes
  6. 6.Compile into research memo

Sample Code

Python example for industry news monitoring

news_monitor.py
import requests
import json

def monitor_industry_news(industry: str, keywords: list, regions: list, api_key: str) -> dict:
    """
    Monitor industry news using Linkup API
    """
    words = ", ".join(keywords)
    geo = ", ".join(regions)

    prompt = f"""
    You are a market intelligence analyst searching for industry news.

    Industry: {industry}
    Keywords to monitor: {words}
    Geographic focus: {geo}

    Search for recent news covering:
    - Market trends and forecasts
    - Regulatory changes and policy updates
    - Major deals (M&A, partnerships, funding rounds)
    - New product or technology announcements
    - Industry challenges or disruptions
    - Expert analysis and commentary

    Prioritize:
    1. Tier-1 business publications (WSJ, Bloomberg, Reuters, Financial Times)
    2. Industry-specific trade publications
    3. Regional business journals for {geo}

    Exclude opinion pieces without factual news content.
    """

    schema = {
        "type": "object",
        "properties": {
            "industry": {"type": "string"},
            "date_range": {"type": "string"},
            "articles": {
                "type": "array",
                "items": {
                    "type": "object",
                    "properties": {
                        "headline": {"type": "string"},
                        "source": {"type": "string"},
                        "date": {"type": "string"},
                        "category": {"type": "string"},
                        "summary": {"type": "string"},
                        "relevance": {"type": "string"}
                    }
                }
            },
            "key_trends": {"type": "array", "items": {"type": "string"}},
            "notable_companies": {"type": "array", "items": {"type": "string"}}
        }
    }

    response = requests.post(
        "https://api.linkup.so/v1/search",
        headers={"Authorization": f"Bearer {api_key}"},
        json={
            "q": prompt,
            "depth": "deep",
            "outputType": "structured",
            "structuredOutputSchema": json.dumps(schema)
        },
        timeout=60
    )

    return response.json()

if __name__ == "__main__":
    API_KEY = "your-api-key"

    result = monitor_industry_news(
        industry="<your-industry>",
        keywords=["<keyword-1>", "<keyword-2>", "<keyword-3>"],
        regions=["<region-1>", "<region-2>"],
        api_key=API_KEY
    )

    print(json.dumps(result, indent=2))
python