> ## Documentation Index
> Fetch the complete documentation index at: https://docs.linkup.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Tasks Endpoint

> _Released: April 2026_

We're excited to introduce the new [**Tasks**](/pages/documentation/endpoints/tasks/overview) endpoint (`/tasks`), which allows you to run Linkup's core endpoints in batch and asynchronously.

Run any combination of [**Search**](/pages/documentation/endpoints/search/reference), [**Fetch**](/pages/documentation/endpoints/fetch/reference), and [**Research**](/pages/documentation/endpoints/research/post) calls in a single batch, with the exact same parameters as their synchronous versions, at no extra cost.

### How to use

1. Send a `POST /tasks` request with an array of `{ type, input }` objects (up to 100 per call). The endpoint immediately returns the tasks' identifiers, before the work is completed.
2. Poll `GET /tasks/{id}` to retrieve a specific task, or `GET /tasks` to list all your tasks.
3. While running, `status` is `"pending"` or `"processing"`. Once the task is `"completed"`, read the result in `output`. If `"failed"`, inspect `error`.

**Example Request**

```shell curl expandable theme={"system"}
curl --request POST \
  --url https://api.linkup.so/v1/tasks \
  --header 'Authorization: Bearer {{LINKUP_API_KEY}}' \
  --header 'Content-Type: application/json' \
  --data '[
  {
    "type": "search",
    "input": {
      "q": "What is Microsoft'\''s 2024 revenue?",
      "depth": "deep",
      "outputType": "sourcedAnswer",
      "includeDomains": ["microsoft.com", "agolution.com"],
      "excludeDomains": ["wikipedia.org"]
    }
  },
  {
    "type": "fetch",
    "input": {
      "url": "https://docs.linkup.so",
      "renderJs": false,
      "includeRawHtml": false,
      "extractImages": false
    }
  },
  {
    "type": "research",
    "input": {
      "q": "What is Microsoft'\''s 2024 revenue?",
      "outputType": "sourcedAnswer",
      "includeImages": true,
      "includeDomains": ["microsoft.com", "agolution.com"],
      "excludeDomains": ["wikipedia.org"]
    }
  }
]'
```

### When to use `/tasks`

* **Bulk workloads** — CRM enrichment, backfilling, batch research over hundreds of queries.
* **Long-running jobs** — submit the request, then poll for the result instead of waiting for the response synchronously.
* **Scheduled pipelines** — kick off a nightly batch, retrieve results in the morning.

For interactive, single-shot calls (chat UIs, agent steps), keep using the synchronous **Search**, **Fetch**, and **Research** endpoints directly.

### Billing

Each task is billed exactly like a direct **Search**, **Fetch**, or **Research** call.

Read the full reference: [`POST /tasks`](/pages/documentation/endpoints/tasks/post) · [`GET /tasks`](/pages/documentation/endpoints/tasks/list) · [`GET /tasks/:id`](/pages/documentation/endpoints/tasks/get).