/tasks

/tasks

curl --request POST \
  --url https://api.linkup.so/v1/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
[
  {
    "input": {
      "depth": "deep",
      "excludeDomains": [
        "wikipedia.org"
      ],
      "includeDomains": [
        "microsoft.com",
        "agolution.com"
      ],
      "outputType": "sourcedAnswer",
      "q": "What is Microsoft's 2024 revenue?"
    },
    "type": "search"
  },
  {
    "input": {
      "extractImages": false,
      "includeRawContent": false,
      "renderJs": false,
      "url": "https://docs.linkup.so"
    },
    "type": "fetch"
  },
  {
    "input": {
      "outputType": "sourcedAnswer",
      "q": "Research the current state of the semiconductor market, covering key market dynamics, major industry players and their strategic positioning, recent analyst sentiment, and the main bull and bear cases for the sector. Ground the report in sourced, factual information."
    },
    "type": "research"
  }
]
EOF

import requests

url = "https://api.linkup.so/v1/tasks"

payload = [
    {
        "input": {
            "depth": "deep",
            "excludeDomains": ["wikipedia.org"],
            "includeDomains": ["microsoft.com", "agolution.com"],
            "outputType": "sourcedAnswer",
            "q": "What is Microsoft's 2024 revenue?"
        },
        "type": "search"
    },
    {
        "input": {
            "extractImages": False,
            "includeRawContent": False,
            "renderJs": False,
            "url": "https://docs.linkup.so"
        },
        "type": "fetch"
    },
    {
        "input": {
            "outputType": "sourcedAnswer",
            "q": "Research the current state of the semiconductor market, covering key market dynamics, major industry players and their strategic positioning, recent analyst sentiment, and the main bull and bear cases for the sector. Ground the report in sourced, factual information."
        },
        "type": "research"
    }
]
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify([
    {
      input: {
        depth: 'deep',
        excludeDomains: ['wikipedia.org'],
        includeDomains: ['microsoft.com', 'agolution.com'],
        outputType: 'sourcedAnswer',
        q: 'What is Microsoft\'s 2024 revenue?'
      },
      type: 'search'
    },
    {
      input: {
        extractImages: false,
        includeRawContent: false,
        renderJs: false,
        url: 'https://docs.linkup.so'
      },
      type: 'fetch'
    },
    {
      input: {
        outputType: 'sourcedAnswer',
        q: 'Research the current state of the semiconductor market, covering key market dynamics, major industry players and their strategic positioning, recent analyst sentiment, and the main bull and bear cases for the sector. Ground the report in sourced, factual information.'
      },
      type: 'research'
    }
  ])
};

fetch('https://api.linkup.so/v1/tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.linkup.so/v1/tasks",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    [
        'input' => [
                'depth' => 'deep',
                'excludeDomains' => [
                                'wikipedia.org'
                ],
                'includeDomains' => [
                                'microsoft.com',
                                'agolution.com'
                ],
                'outputType' => 'sourcedAnswer',
                'q' => 'What is Microsoft\'s 2024 revenue?'
        ],
        'type' => 'search'
    ],
    [
        'input' => [
                'extractImages' => false,
                'includeRawContent' => false,
                'renderJs' => false,
                'url' => 'https://docs.linkup.so'
        ],
        'type' => 'fetch'
    ],
    [
        'input' => [
                'outputType' => 'sourcedAnswer',
                'q' => 'Research the current state of the semiconductor market, covering key market dynamics, major industry players and their strategic positioning, recent analyst sentiment, and the main bull and bear cases for the sector. Ground the report in sourced, factual information.'
        ],
        'type' => 'research'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.linkup.so/v1/tasks"

	payload := strings.NewReader("[\n  {\n    \"input\": {\n      \"depth\": \"deep\",\n      \"excludeDomains\": [\n        \"wikipedia.org\"\n      ],\n      \"includeDomains\": [\n        \"microsoft.com\",\n        \"agolution.com\"\n      ],\n      \"outputType\": \"sourcedAnswer\",\n      \"q\": \"What is Microsoft's 2024 revenue?\"\n    },\n    \"type\": \"search\"\n  },\n  {\n    \"input\": {\n      \"extractImages\": false,\n      \"includeRawContent\": false,\n      \"renderJs\": false,\n      \"url\": \"https://docs.linkup.so\"\n    },\n    \"type\": \"fetch\"\n  },\n  {\n    \"input\": {\n      \"outputType\": \"sourcedAnswer\",\n      \"q\": \"Research the current state of the semiconductor market, covering key market dynamics, major industry players and their strategic positioning, recent analyst sentiment, and the main bull and bear cases for the sector. Ground the report in sourced, factual information.\"\n    },\n    \"type\": \"research\"\n  }\n]")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.linkup.so/v1/tasks")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("[\n  {\n    \"input\": {\n      \"depth\": \"deep\",\n      \"excludeDomains\": [\n        \"wikipedia.org\"\n      ],\n      \"includeDomains\": [\n        \"microsoft.com\",\n        \"agolution.com\"\n      ],\n      \"outputType\": \"sourcedAnswer\",\n      \"q\": \"What is Microsoft's 2024 revenue?\"\n    },\n    \"type\": \"search\"\n  },\n  {\n    \"input\": {\n      \"extractImages\": false,\n      \"includeRawContent\": false,\n      \"renderJs\": false,\n      \"url\": \"https://docs.linkup.so\"\n    },\n    \"type\": \"fetch\"\n  },\n  {\n    \"input\": {\n      \"outputType\": \"sourcedAnswer\",\n      \"q\": \"Research the current state of the semiconductor market, covering key market dynamics, major industry players and their strategic positioning, recent analyst sentiment, and the main bull and bear cases for the sector. Ground the report in sourced, factual information.\"\n    },\n    \"type\": \"research\"\n  }\n]")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.linkup.so/v1/tasks")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "[\n  {\n    \"input\": {\n      \"depth\": \"deep\",\n      \"excludeDomains\": [\n        \"wikipedia.org\"\n      ],\n      \"includeDomains\": [\n        \"microsoft.com\",\n        \"agolution.com\"\n      ],\n      \"outputType\": \"sourcedAnswer\",\n      \"q\": \"What is Microsoft's 2024 revenue?\"\n    },\n    \"type\": \"search\"\n  },\n  {\n    \"input\": {\n      \"extractImages\": false,\n      \"includeRawContent\": false,\n      \"renderJs\": false,\n      \"url\": \"https://docs.linkup.so\"\n    },\n    \"type\": \"fetch\"\n  },\n  {\n    \"input\": {\n      \"outputType\": \"sourcedAnswer\",\n      \"q\": \"Research the current state of the semiconductor market, covering key market dynamics, major industry players and their strategic positioning, recent analyst sentiment, and the main bull and bear cases for the sector. Ground the report in sourced, factual information.\"\n    },\n    \"type\": \"research\"\n  }\n]"

response = http.request(request)
puts response.read_body

[
  {
    "createdAt": "2026-01-01T00:00:00.000Z",
    "error": "<string>",
    "id": "01234-abcd-56789",
    "status": "completed",
    "updatedAt": "2026-01-01T00:00:00.000Z",
    "input": {
      "q": "What is Microsoft's 2024 revenue?",
      "toDate": "2025-01-01",
      "depth": "deep",
      "includeImages": false,
      "includeInlineCitations": false,
      "includeSources": false,
      "outputType": "searchResults",
      "excludeDomains": [
        "wikipedia.org"
      ],
      "fromDate": "2025-01-01",
      "includeDomains": [
        "microsoft.com",
        "agolution.com"
      ],
      "structuredOutputSchema": null,
      "maxResults": 5
    },
    "output": {
      "answer": "Microsoft's revenue for fiscal year 2024 was $245.1 billion, reflecting a 16% increase from the previous year.",
      "sources": [
        {
          "name": "Microsoft 2024 Annual Report",
          "snippet": "Highlights from fiscal year 2024 compared with fiscal year 2023 included: Microsoft Cloud revenue increased 23% to $137.4 billion.",
          "url": "https://www.microsoft.com/investor/reports/ar24/index.html"
        }
      ]
    },
    "type": "search"
  }
]

POST

tasks

/tasks

curl --request POST \
  --url https://api.linkup.so/v1/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
[
  {
    "input": {
      "depth": "deep",
      "excludeDomains": [
        "wikipedia.org"
      ],
      "includeDomains": [
        "microsoft.com",
        "agolution.com"
      ],
      "outputType": "sourcedAnswer",
      "q": "What is Microsoft's 2024 revenue?"
    },
    "type": "search"
  },
  {
    "input": {
      "extractImages": false,
      "includeRawContent": false,
      "renderJs": false,
      "url": "https://docs.linkup.so"
    },
    "type": "fetch"
  },
  {
    "input": {
      "outputType": "sourcedAnswer",
      "q": "Research the current state of the semiconductor market, covering key market dynamics, major industry players and their strategic positioning, recent analyst sentiment, and the main bull and bear cases for the sector. Ground the report in sourced, factual information."
    },
    "type": "research"
  }
]
EOF

import requests

url = "https://api.linkup.so/v1/tasks"

payload = [
    {
        "input": {
            "depth": "deep",
            "excludeDomains": ["wikipedia.org"],
            "includeDomains": ["microsoft.com", "agolution.com"],
            "outputType": "sourcedAnswer",
            "q": "What is Microsoft's 2024 revenue?"
        },
        "type": "search"
    },
    {
        "input": {
            "extractImages": False,
            "includeRawContent": False,
            "renderJs": False,
            "url": "https://docs.linkup.so"
        },
        "type": "fetch"
    },
    {
        "input": {
            "outputType": "sourcedAnswer",
            "q": "Research the current state of the semiconductor market, covering key market dynamics, major industry players and their strategic positioning, recent analyst sentiment, and the main bull and bear cases for the sector. Ground the report in sourced, factual information."
        },
        "type": "research"
    }
]
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify([
    {
      input: {
        depth: 'deep',
        excludeDomains: ['wikipedia.org'],
        includeDomains: ['microsoft.com', 'agolution.com'],
        outputType: 'sourcedAnswer',
        q: 'What is Microsoft\'s 2024 revenue?'
      },
      type: 'search'
    },
    {
      input: {
        extractImages: false,
        includeRawContent: false,
        renderJs: false,
        url: 'https://docs.linkup.so'
      },
      type: 'fetch'
    },
    {
      input: {
        outputType: 'sourcedAnswer',
        q: 'Research the current state of the semiconductor market, covering key market dynamics, major industry players and their strategic positioning, recent analyst sentiment, and the main bull and bear cases for the sector. Ground the report in sourced, factual information.'
      },
      type: 'research'
    }
  ])
};

fetch('https://api.linkup.so/v1/tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.linkup.so/v1/tasks",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    [
        'input' => [
                'depth' => 'deep',
                'excludeDomains' => [
                                'wikipedia.org'
                ],
                'includeDomains' => [
                                'microsoft.com',
                                'agolution.com'
                ],
                'outputType' => 'sourcedAnswer',
                'q' => 'What is Microsoft\'s 2024 revenue?'
        ],
        'type' => 'search'
    ],
    [
        'input' => [
                'extractImages' => false,
                'includeRawContent' => false,
                'renderJs' => false,
                'url' => 'https://docs.linkup.so'
        ],
        'type' => 'fetch'
    ],
    [
        'input' => [
                'outputType' => 'sourcedAnswer',
                'q' => 'Research the current state of the semiconductor market, covering key market dynamics, major industry players and their strategic positioning, recent analyst sentiment, and the main bull and bear cases for the sector. Ground the report in sourced, factual information.'
        ],
        'type' => 'research'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.linkup.so/v1/tasks"

	payload := strings.NewReader("[\n  {\n    \"input\": {\n      \"depth\": \"deep\",\n      \"excludeDomains\": [\n        \"wikipedia.org\"\n      ],\n      \"includeDomains\": [\n        \"microsoft.com\",\n        \"agolution.com\"\n      ],\n      \"outputType\": \"sourcedAnswer\",\n      \"q\": \"What is Microsoft's 2024 revenue?\"\n    },\n    \"type\": \"search\"\n  },\n  {\n    \"input\": {\n      \"extractImages\": false,\n      \"includeRawContent\": false,\n      \"renderJs\": false,\n      \"url\": \"https://docs.linkup.so\"\n    },\n    \"type\": \"fetch\"\n  },\n  {\n    \"input\": {\n      \"outputType\": \"sourcedAnswer\",\n      \"q\": \"Research the current state of the semiconductor market, covering key market dynamics, major industry players and their strategic positioning, recent analyst sentiment, and the main bull and bear cases for the sector. Ground the report in sourced, factual information.\"\n    },\n    \"type\": \"research\"\n  }\n]")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.linkup.so/v1/tasks")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("[\n  {\n    \"input\": {\n      \"depth\": \"deep\",\n      \"excludeDomains\": [\n        \"wikipedia.org\"\n      ],\n      \"includeDomains\": [\n        \"microsoft.com\",\n        \"agolution.com\"\n      ],\n      \"outputType\": \"sourcedAnswer\",\n      \"q\": \"What is Microsoft's 2024 revenue?\"\n    },\n    \"type\": \"search\"\n  },\n  {\n    \"input\": {\n      \"extractImages\": false,\n      \"includeRawContent\": false,\n      \"renderJs\": false,\n      \"url\": \"https://docs.linkup.so\"\n    },\n    \"type\": \"fetch\"\n  },\n  {\n    \"input\": {\n      \"outputType\": \"sourcedAnswer\",\n      \"q\": \"Research the current state of the semiconductor market, covering key market dynamics, major industry players and their strategic positioning, recent analyst sentiment, and the main bull and bear cases for the sector. Ground the report in sourced, factual information.\"\n    },\n    \"type\": \"research\"\n  }\n]")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.linkup.so/v1/tasks")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "[\n  {\n    \"input\": {\n      \"depth\": \"deep\",\n      \"excludeDomains\": [\n        \"wikipedia.org\"\n      ],\n      \"includeDomains\": [\n        \"microsoft.com\",\n        \"agolution.com\"\n      ],\n      \"outputType\": \"sourcedAnswer\",\n      \"q\": \"What is Microsoft's 2024 revenue?\"\n    },\n    \"type\": \"search\"\n  },\n  {\n    \"input\": {\n      \"extractImages\": false,\n      \"includeRawContent\": false,\n      \"renderJs\": false,\n      \"url\": \"https://docs.linkup.so\"\n    },\n    \"type\": \"fetch\"\n  },\n  {\n    \"input\": {\n      \"outputType\": \"sourcedAnswer\",\n      \"q\": \"Research the current state of the semiconductor market, covering key market dynamics, major industry players and their strategic positioning, recent analyst sentiment, and the main bull and bear cases for the sector. Ground the report in sourced, factual information.\"\n    },\n    \"type\": \"research\"\n  }\n]"

response = http.request(request)
puts response.read_body

[
  {
    "createdAt": "2026-01-01T00:00:00.000Z",
    "error": "<string>",
    "id": "01234-abcd-56789",
    "status": "completed",
    "updatedAt": "2026-01-01T00:00:00.000Z",
    "input": {
      "q": "What is Microsoft's 2024 revenue?",
      "toDate": "2025-01-01",
      "depth": "deep",
      "includeImages": false,
      "includeInlineCitations": false,
      "includeSources": false,
      "outputType": "searchResults",
      "excludeDomains": [
        "wikipedia.org"
      ],
      "fromDate": "2025-01-01",
      "includeDomains": [
        "microsoft.com",
        "agolution.com"
      ],
      "structuredOutputSchema": null,
      "maxResults": 5
    },
    "output": {
      "answer": "Microsoft's revenue for fiscal year 2024 was $245.1 billion, reflecting a 16% increase from the previous year.",
      "sources": [
        {
          "name": "Microsoft 2024 Annual Report",
          "snippet": "Highlights from fiscal year 2024 compared with fiscal year 2023 included: Microsoft Cloud revenue increased 23% to $137.4 billion.",
          "url": "https://www.microsoft.com/investor/reports/ar24/index.html"
        }
      ]
    },
    "type": "search"
  }
]

Get your API key

Create a Linkup account for free to get your API key.

This is an asynchronous endpoint. It immediately returns the tasks’ identifiers, before they complete. Use GET /v1/tasks/:id to poll for a specific task, or GET /v1/tasks to list all your tasks.

For batch sizing, polling strategies, and example workloads, see the Tasks overview.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Required array length: 1 - 100 elements

Option 1
Option 2
Option 3
Option 4

input

object

required

Show child attributes

type

string

required

Allowed value: "search"

Example:

[
  {
    "input": {
      "depth": "deep",
      "excludeDomains": ["wikipedia.org"],
      "includeDomains": ["microsoft.com", "agolution.com"],
      "outputType": "sourcedAnswer",
      "q": "What is Microsoft's 2024 revenue?"
    },
    "type": "search"
  },
  {
    "input": {
      "extractImages": false,
      "includeRawContent": false,
      "renderJs": false,
      "url": "https://docs.linkup.so"
    },
    "type": "fetch"
  },
  {
    "input": {
      "outputType": "sourcedAnswer",
      "q": "Research the current state of the semiconductor market, covering key market dynamics, major industry players and their strategic positioning, recent analyst sentiment, and the main bull and bear cases for the sector. Ground the report in sourced, factual information."
    },
    "type": "research"
  }
]

Response

Tasks created successfully.

Option 1
Option 2
Option 3
Option 4

createdAt

string<date-time>

required

The date and time when the task was created.

Pattern:

^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$

Example:

"2026-01-01T00:00:00.000Z"

error

string | null

required

The error message if the task failed.

string

required

The unique identifier of the task.

Example:

"01234-abcd-56789"

status

enum<string>

required

The current status of the task.

Available options:

completed,

failed,

pending,

processing

Example:

"completed"

updatedAt

string<date-time>

required

The date and time when the task status was last updated.

Pattern:

^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$

Example:

"2026-01-01T00:00:00.000Z"

input

object

required

Show child attributes

output

object

required

Option 1
Option 2
Option 3
Option 4

Show child attributes

type

string

required

Allowed value: "search"

Search

Fetch

Research

Tasks

Extract (closed beta)

Account

Get your API key

Authorizations

Body

Response