orthogonal-sh/linkup

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