← Back to Linkup

Search

The /search endpoint allows you to retrieve web content.

Linkup·$0.01 per call

Example code

// Using @orth/sdk - The simplest way to call APIs // Install: npm install @orth/sdk import Orthogonal from "@orth/sdk"; const orthogonal = new Orthogonal({ apiKey: process.env.ORTHOGONAL_API_KEY, }); const output = await orthogonal.run({ api: "linkup", path: "/search", body: { "q": "example", "depth": "example", "outputType": "example" } }); console.log(output);

Body parameters

qrequired
string

The natural language question for which you want to retrieve context.

depthrequired
string

Defines the precision of the search. standard returns results faster; deep takes longer but yields more comprehensive results.

outputTyperequired
string

The type of output you want to get. Use structured for a custom-formatted response defined by structuredOutputSchema.

structuredOutputSchema
object

Required only when outputType is structured. Provide a JSON schema (as a string) representing the desired response format. The root must be of type object.

includeSources
boolean

Relevant only when outputType is structured. Defines whether the response should include sources. Please note that it modifies the schema of the response, see below

includeImages
boolean

Defines whether the API should include images in its results.

fromDate
string

The date from which the search results should be considered, in ISO 8601 format (YYYY-MM-DD). It must be before toDate, if provided, and later than 1970-01-01.

toDate
string

The date until which the search results should be considered, in ISO 8601 format (YYYY-MM-DD). It must be later than fromDate, if provided, or than 1970-01-01.

includeDomains
string

The domains you want to search on. By default, don't restrict the search. You can provide up to 100 domains.

excludeDomains
string

The domains you want to exclude of the search. By default, don't restrict the search.

includeInlineCitations
boolean

Relevant only when outputType is sourcedAnswer. Defines whether the answer should include inline citations.

maxResults
number

The maximum number of results to return.

Response

results
array

Array of search results. Returned when outputType is searchResults.

results[].name
string

Title of the source page.

results[].url
string

URL of the source page.

results[].content
string

Extracted content snippet from the source.

answer
string

LLM-composed answer with source attribution. Returned when outputType is sourcedAnswer.

sources
array

Array of sources used to compose the answer. Returned when outputType is sourcedAnswer or when includeSources is true with structured output.

sources[].name
string

Title of the source page.

sources[].url
string

URL of the source page.

sources[].snippet
string

Relevant excerpt from the source.

images
array

Array of images found in search results. Only present when includeImages is true.

images[].url
string

URL of the image.

images[].alt
string

Alt text of the image.

    Orthogonal - Giving AI agents the tools they need.