LIlinkup
Search

/search

Changed on

The /search endpoint allows you to retrieve web content.

post/v1/search

Request

  • Base URL
    https://api.linkup.so
  • URL
    https://api.linkup.so/v1/search
  • Auth
    HTTP bearer

Request body

excludeDomainsstring[]

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

fromDatestring nullable

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.

includeDomainsstring[]

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

qstring required

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

structuredOutputSchemaunknown
toDatestring nullable

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.

depth'deep' | 'fast' | 'flash' | 'standard' required

Defines the search mode. flash is lowest latency: ranked sources and snippets in a few hundred milliseconds, built for low-latency use cases. fast is higher-quality one-shot retrieval in about a second — the recommended default for most agentic applications. standard is a single pass of agentic search for queries that span several topics or sources. deep runs several search iterations, optimizing for coverage and multi-hop agentic workflows.

maxResultsnumber

The maximum number of results to return. The number of results will always be ≤ to maxResults.

outputType'searchResults' | 'sourcedAnswer' | 'structured' required

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

Example request

{
  "depth": "deep",
  "excludeDomains": [
    "wikipedia.org"
  ],
  "includeDomains": [
    "microsoft.com",
    "agolution.com"
  ],
  "outputType": "sourcedAnswer",
  "q": "What is Microsoft's 2024 revenue?"
}

Response

Successful response

Changes