Linkup - Web Search & Fetch API

Search the web and fetch content from any URL.

Capabilities

• •Search: The /search endpoint allows you to retrieve web content
• •Fetch: The /fetch endpoint allows you to fetch a single webpage from a given URL

Usage

Search

The /search endpoint allows you to retrieve web content.

Parameters:

• •q* (string) - The natural language question for which you want to retrieve context.
• •depth* (string) - Defines the precision of the search. standard returns results faster; deep takes longer but yields more comprehensive results.
• •outputType* (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.

orth api run linkup /search --body '{
  "q": "latest AI developments 2024",
  "depth": "standard",
  "outputType": "sourcedAnswer"
}'

Fetch

The /fetch endpoint allows you to fetch a single webpage from a given URL.

Parameters:

• •url* (string) - The URL of the webpage you want to fetch.
• •renderJs (boolean) - Defines whether the API should render the JavaScript of the webpage.
• •includeRawHtml (boolean) - Defines whether the API should include the raw HTML of the webpage in its response.
• •extractImages (boolean) - Defines whether the API should extract the images from the webpage in its response.

orth api run linkup /fetch --body '{"url": "https://example.com/article"}'

Use Cases

1. •Research: Search for information on any topic
2. •Content Aggregation: Fetch and process web content
3. •Fact Checking: Verify information from multiple sources
4. •News Monitoring: Track news on specific topics

Discover More

For full endpoint details and parameters:

orth api show linkup              # List all endpoints
orth api show linkup /search   # Get endpoint details