# Linkup

Linkup is a search engine that allows you to search the web for relevant results.

- **Category:** ai web scraping
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 5
- **Triggers:** 0
- **Slug:** `LINKUP`
- **Version:** 20260316_00

## Tools

### Create Response

**Slug:** `LINKUP_CREATE_RESPONSE`

Proxy endpoint for OpenAI-compatible response generation. Used when the OpenAI client's base URL is set to Linkup. Supports 'linkup-standard' for faster results and 'linkup-deep' for more comprehensive results.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `text` | object | No | Optional custom text format configuration. |
| `input` | string | Yes | The natural language question for which you want to retrieve context. Must be a plain string, not an object or array. |
| `model` | string ("linkup-deep" | "linkup-standard") | Yes | The model used to generate the response. 'linkup-standard' returns results faster; 'linkup-deep' takes longer but yields more comprehensive results. |
| `instructions` | string | No | Optional instructions to guide the response generation. Similar to a system message. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Fetch Webpage

**Slug:** `LINKUP_FETCH_WEBPAGE`

Fetch and retrieve a markdown representation of a webpage from a given URL. Supports optional JavaScript rendering for single-page applications, raw HTML extraction, and image extraction from the webpage content. Use this when you need to extract clean, structured content from web pages.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | The URL of the webpage to fetch |
| `renderJs` | boolean | No | Whether to render JavaScript on the webpage before fetching content. Set to true for single-page applications or dynamic content |
| `extractImages` | boolean | No | Whether to extract images from the webpage and include them in the response |
| `includeRawHtml` | boolean | No | Whether to include the raw HTML of the webpage in the response |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Credits Balance

**Slug:** `LINKUP_GET_CREDITS_BALANCE`

Tool to retrieve the current credits balance for your Linkup account. Returns the number of credits remaining that can be used for search and fetch operations.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Linkup

**Slug:** `LINKUP_SEARCH`

Search the web and retrieve insights using Linkup's API. This action provides three output modes: natural language answers with sources (sourcedAnswer), raw search context (searchResults), or custom structured JSON (structured). Supports filtering by date range and domains, with optional image results. Standard depth uses 1 credit, deep search uses 10 credits. Only indexes publicly available web content; private repositories and internal endpoints return no results.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `depth` | string ("standard" | "deep") | No | Level of search depth. 'standard' is faster and uses 1 credit, 'deep' is more comprehensive and uses 10 credits |
| `query` | string | Yes | The natural language question for which you want to retrieve context |
| `to_date` | string | No | Filter results up to this date in ISO 8601 format (YYYY-MM-DD) |
| `from_date` | string | No | Filter results from this date onwards in ISO 8601 format (YYYY-MM-DD) |
| `max_results` | integer | No | Maximum number of results to return |
| `output_type` | string ("sourcedAnswer" | "searchResults" | "structured") | No | Type of output: 'sourcedAnswer' provides a natural language answer with citations, 'searchResults' returns raw search context, 'structured' returns custom JSON format Response fields: `sourcedAnswer` returns `answer` (str) and `sources` (list); `searchResults` returns `results` array with `name`, `url`, `content` per item; `structured` returns schema-defined JSON. |
| `include_images` | boolean | No | Whether to include image results in the response |
| `exclude_domains` | array | No | Exclude these domains from search results |
| `include_domains` | array | No | Only search within these domains (up to 100 domains) |
| `include_sources` | boolean | No | Adds sources to structured responses. Only applicable when output_type is 'structured' |
| `include_inline_citations` | boolean | No | Embeds citations directly within the answer text. Only applicable when output_type is 'sourcedAnswer' |
| `structured_output_schema` | string | No | JSON schema defining the custom response format. Required when output_type is 'structured' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |