> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getcargo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Linkup

> Search the web and get AI-powered answers with Linkup

Linkup is an AI-powered search API that provides real-time web search results and structured answers. The Cargo integration enables you to enrich your data with live web information.

## Authentication

Connect to Linkup using your API key.

### Connection details

| Field       | Description         |
| ----------- | ------------------- |
| **API key** | Your Linkup API key |

***

## Linkup actions

### Search

Search the web for relevant content using natural language queries.

**Configuration**

| Field            | Description                                  |
| ---------------- | -------------------------------------------- |
| **Query**        | Natural language question or search query    |
| **Search Depth** | Standard (quick) or Deep (thorough, agentic) |

**Search depth options**

| Depth        | Description                           | Credits |
| ------------ | ------------------------------------- | ------- |
| **Standard** | Quick search with standard accuracy   | 0.5     |
| **Deep**     | Thorough search with agentic thinking | 2       |

### Instruct

Get structured or sourced answers to your questions.

**Configuration**

| Field                        | Description                                        |
| ---------------------------- | -------------------------------------------------- |
| **Query**                    | Natural language question                          |
| **Search Depth**             | Standard or Deep search                            |
| **Output Type**              | Sourced answer or Structured response              |
| **Structured Output Schema** | JSON schema for structured responses (if selected) |

**Output types**

| Type               | Description                     |
| ------------------ | ------------------------------- |
| **Sourced answer** | Direct answer with source links |
| **Structured**     | Custom-formatted JSON response  |

<Tip>
  Use structured output to extract specific data points like company information, product details, or competitive intelligence.
</Tip>

***

## Credits

| Action   | Cost                       |
| -------- | -------------------------- |
| Search   | 0.5 (standard) or 2 (deep) |
| Instruct | 1 credit per request       |

***

## Use cases

<AccordionGroup>
  <Accordion title="Company research" icon="building">
    Get real-time information about companies, products, and news.
  </Accordion>

  <Accordion title="Competitive intelligence" icon="magnifying-glass">
    Research competitors and market trends with sourced answers.
  </Accordion>

  <Accordion title="Data enrichment" icon="database">
    Enrich records with live web data using structured outputs.
  </Accordion>
</AccordionGroup>

***

## Best practices

1. **Use deep search for complex queries** - Deep search provides more thorough results for nuanced questions
2. **Define clear schemas** - For structured output, define precise JSON schemas for consistent results
3. **Include context in queries** - More specific queries yield better results