Date filtering information can be found here.

Overview

You can fine-tune your search results by:

  • including
  • excluding
  • prioritizing

specific domains or URLs, ensuring more control over where your answers are retrieved from.

If you use excludeDomains and includeDomains, the results will logically only include URLs that match the inclusion.

Exclude Domains/URLs

To filter your search results by exclusively excluding some URLs or domains, you can add the excludeDomains parameter to your API request.

Example Request with excludeDomains

curl --request POST \
  --url https://api.linkup.so/v1/search \
  --header 'Authorization: {{LINKUP_API_KEY}}' \
  --header 'Content-Type: application/json' \
  --data '{
  "q": "Latest developments in AI",
  "depth": "standard",
  "outputType": "sourcedAnswer",
  "excludeDomains": ["apple.com"]
}'

Example Response

{
  "answer": "AI agents are the dominant innovation in 2025, focusing on autonomous AI programs that can independently complete projects...",
  "sources": [
    {
      "name": "AI Agents in 2025: Expectations vs. Reality | IBM",
      "snippet": "For 2025, the dominant innovation narrative is the AI agent...",
      "url": "https://www.ibm.com/think/insights/ai-agents-2025-expectations-vs-reality"
    }
  ]
}

Include Domains/URLs

To filter your search results by exclusively consulting some URLs or domains, you can add the includeDomains parameter to your API request.

Example Request with includeDomains

curl --request POST \
  --url https://api.linkup.so/v1/search \
  --header 'Authorization: {{LINKUP_API_KEY}}' \
  --header 'Content-Type: application/json' \
  --data '{
  "q": "How to build MCP server",
  "depth": "standard",
  "outputType": "sourcedAnswer",
  "includeDomains": ["dev.to"]
}'

Example Response

{
  "answer": "Steps to build an MCP server in 2025:[...]",
  "sources": [
    {
      "name": "🚀Top 10 MCP Servers for 2025 (Yes, GitHub’s Included!) - DEV Community",
      "snippet": "Enter the Model Context Protocol ... ",
      "url": "https://dev.to/fallon_jimmy/top-10-mcp-servers-for-2025-yes-githubs-included-15jg"
    }
  ]
}

Prioritize Domains

To Prioritize some domains, you can use the <guidance> XML structure in your query.

Example Request with Prioritize

curl -X POST 'https://api.linkup.so/v1/search' \
  -H 'Authorization: Bearer {{LINKUP_API_KEY}}' \
  -H 'Content-Type: application/json' \
  -d '{
    "q": "<guidance>Use only the sources listed here. Do not rely on any external references.\n  - wikipedia.org\n  - lvmh.com\n<priority>\n  - wikipedia.org\n</priority></guidance>Who is the CEO of LVMH?",
    "outputType": "sourcedAnswer",
    "depth": "standard"
  }'

Example Response

{
  "answer": "The CEO of LVMH is Bernard Arnault.",
  "sources": [
    {
      "name": "Actual CEO of LVMH",
      "url": "https://www.wikipedia.org/wiki/lvmh",
      "snippet": "LVMH Moët Hennessy Louis Vuitton SE, commonly known as LVMH, is a French multinational luxury goods conglomerate. The current CEO is Bernard Arnault."
    },
    {
      "name": "The CEO of LVMH is Bernard Arnault",
      "url": "https://lvmh.com/about-us",
      "snippet": "Bernard Arnault is the CEO of LVMH, a leading luxury goods company. Under his leadership, LVMH has seen significant growth and expansion in the luxury market."
    }
  ]
}