# Linkup Deep Search (Iterative Multi-Query Agentic Retrieval)

> Linkup Deep Search (Iterative Multi-Query Agentic Retrieval) is a paid API for AI agents from vaaya.ai, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Performs deep, iterative multi-query agentic web search to answer complex or multi-hop questions that single-pass search cannot resolve.

## Facts

- Endpoint: POST https://vaaya.ai/api/run/linkup/deep-search
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/linkup-deep-search-iterative-multi-query-agentic-retrieval-adeaf272
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BUOBb0414l6T1HMlZO_x0

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability linkup-deep-search-iterative-multi-query-agentic-retrieval-adeaf272 -d '<json body>'
```

Example prompt: I need a thorough, cited answer to a complex research question: 'How has the regulatory landscape for stablecoins evolved across the US, EU, and UK since 2020, and what are the key differences in their current frameworks?' Use deep iterative search to cover all angles.

## When to prefer this

Use this endpoint only after a standard single-pass search (e.g. linkup/search or exa/search) has returned insufficient or thin results for a complex, multi-hop, or hard research question. It is 5× more expensive and significantly slower than standard search, so it should be reserved for questions that genuinely require iterative query refinement, cross-source synthesis, or multi-hop reasoning. Do not use it for simple factual lookups or when speed is critical.

## Known failure modes

- Query too vague to iterate meaningfully — returns thin or generic results
- Timeout if the iterative search exceeds platform limits
- Domain filter too restrictive — no relevant results found within scope
- Rate limiting or quota exceeded — service returns error
- Underlying Linkup provider unavailable — upstream error propagated

## How this service works

Linkup — DEEP agentic search: iterative multi-query retrieval for hard or multi-hop questions where one-pass search misses. Same params as linkup/search (`q` + outputType/dates/domain filters). Slower (tens of seconds) and 5× the price — escalate here only after linkup/search or exa/search come back thin. For full multi-step research reports, parallel/task (10-30¢) is the bigger rung.

## Output

A cited, synthesized answer or ranked set of results drawn from multiple iterative web searches; may include source URLs, extracted evidence passages, and a composed response to the query. Response time is in the range of tens of seconds.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "$schema": "http://json-schema.org/draft-07/schema#",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "maxLength": 4000,
       "minLength": 1
      },
      "toDate": {
       "type": "string",
       "maxLength": 30,
       "minLength": 4
      },
      "fromDate": {
       "type": "string",
       "maxLength": 30,
       "minLength": 4
      },
      "outputType": {
       "enum": [
        "sourcedAnswer",
        "searchResults",
        "structured"
       ],
       "type": "string"
      },
      "includeImages": {
       "type": "boolean"
      },
      "excludeDomains": {
       "type": "array",
       "items": {
        "type": "string"
       }
      },
      "includeDomains": {
       "type": "array",
       "items": {
        "type": "string"
       }
      },
      "includeInlineCitations": {
       "type": "boolean"
      },
      "structuredOutputSchema": {
       "type": "string",
       "minLength": 2
      }
     },
     "additionalProperties": false
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/linkup-deep-search-iterative-multi-query-agentic-retrieval-adeaf272/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from vaaya.ai](https://www.zero.xyz/host/vaaya.ai/llms.txt)