0

Create research task

Published today

Start an asynchronous Linkup research task that browses the web and returns a sourced answer or structured report. Poll it with Get research task.

Script linkup Verified

The script

Submitted by hugo989 Typescript (fetch-only)
Verified 3 hours ago
1
//native
2

3
/**
4
 * Create research task
5
 * Start an asynchronous Linkup research task that browses the web and returns a sourced answer or structured report. Poll it with Get research task.
6
 */
7
export async function main(
8
  auth: RT.Linkup,
9
  query: string,
10
  output_type: "sourcedAnswer" | "structured",
11
  structured_output_schema: { [key: string]: any } | undefined,
12
  mode: "auto" | "answer" | "investigate" | "research" | undefined,
13
  reasoning_depth: "S" | "M" | "L" | "XL" | undefined,
14
  include_domains: string[] | undefined,
15
  exclude_domains: string[] | undefined,
16
  from_date: string | undefined,
17
  to_date: string | undefined
18
) {
19
  const url = new URL("https://api.linkup.so/v1/research")
20

21
  const hasSchema =
22
    structured_output_schema != null &&
23
    Object.keys(structured_output_schema).length > 0
24

25
  const response = await fetch(url, {
26
    method: "POST",
27
    headers: {
28
      Authorization: `Bearer ${auth.token}`,
29
      "Content-Type": "application/json",
30
      Accept: "application/json",
31
    },
32
    body: JSON.stringify({
33
      q: query,
34
      outputType: output_type || "sourcedAnswer",
35
      structuredOutputSchema: hasSchema
36
        ? JSON.stringify(structured_output_schema)
37
        : undefined,
38
      mode: mode || undefined,
39
      reasoningDepth: reasoning_depth || undefined,
40
      includeDomains: include_domains?.length ? include_domains : undefined,
41
      excludeDomains: exclude_domains?.length ? exclude_domains : undefined,
42
      fromDate: from_date || undefined,
43
      toDate: to_date || undefined,
44
    }),
45
  })
46

47
  if (!response.ok) {
48
    throw new Error(`${response.status} ${await response.text()}`)
49
  }
50

51
  return await response.json()
52
}
53