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