Linkup web search
linkup-searchSearch the web for fresh, cited results, answers, or structured data using keyword or agentic queries. Read LinkedIn profile, company, and post pages by passing their exact URLs.
Instructions
Search the web with Linkup (POST /v1/search, synchronous).
Cost per call: flash, fast or standard 0.005 USD (searchResults) or 0.006 (sourcedAnswer, structured); deep 0.05 or 0.055. Rate limit 10 requests per second per organisation. A query without results returns HTTP 400 and is not billed. LinkedIn profile, company and post pages can only be read through this endpoint (give the exact URL in the query with standard or deep), not through linkup-fetch.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "linkup-search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| depth | No | flash: ranked snippets in under 200 ms, no LLM (alpha). fast: one-shot keyword retrieval in about 1 s, the recommended default. standard: one agentic pass, 1 to 3 s, can fan out into parallel sub-searches. deep: several iterations with sequential instructions, 5 to 30 s. | fast |
| query | Yes | Natural-language query. flash and fast are keyword-only (write 'NVIDIA Q4 2024 revenue'); standard and deep follow instructions (name what to retrieve, then how to shape the answer; standard can scrape one URL given in the query, deep several, in order). | |
| to_date | No | YYYY-MM-DD. | |
| from_date | No | YYYY-MM-DD. Put date ranges here, not in the query. | |
| max_chars | No | Cap on the size of the returned JSON; long strings are truncated and _truncated is set. | |
| max_results | No | Upper bound on the number of results (minimum 1). | |
| output_type | No | searchResults: raw results (name, url, content, publishedAt) for you to reason over. sourcedAnswer: an answer plus sources. structured: JSON matching structured_output_schema. | searchResults |
| include_images | No | Also return image results. | |
| exclude_domains | No | Domains to exclude. | |
| include_domains | No | Restrict to these domains (up to 100). Recommended when authoritative sources are known. | |
| include_sources | No | structured only: also return the sources; the response then has data and sources. | |
| include_inline_citations | No | sourcedAnswer only: add inline citations to the answer text. | |
| structured_output_schema | No | Required when output_type is structured. JSON Schema (object or string) with root type object. Keep it flat. |