We’re excited to introduce URL filtering capabilities for your search results. This new feature allows you to exclude or obligate some URLs on your search results, making it easier to find the most relevant information.

​
How to Enable

To filter your search results by URLs or domains, add the excludeDomains or includeDomains parameters 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"
    }
  ]
}

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"
    }
  ]
}

The URLs filtering parameters accept an Array of strings. You can use:

  • excludeDomains: Don’t use those Domains/URLs in the results
  • includeDomains: Only use those Domains/URLs in the results

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