# OttoKit

> Add web search, news and web page reading to OttoKit workflows with the native Search1API app.

Canonical URL: https://s1.dev/docs/integrations/ottokit

The Search1API app for [OttoKit](https://ottokit.com/integrations/search1api) gives your workflows live web access without hand-built HTTP requests. Search the web or specific sites, find the latest news, and turn any web page into clean text that an AI step can summarize.

## Connect

1. Create or copy a key on the **API Keys** page in the [Search1API dashboard](https://app.s1.dev).
2. In an OttoKit workflow, click **Add Action** and pick **Search1API**.
3. Choose an action, then under **Select Connection** click **Create New Connection** and paste the key into **API Key**.

Connecting checks the key against the read-only `/usage` endpoint and does not spend a search.

## Actions

| Action | What it does |
| --- | --- |
| **Search the Web** | Search the web and get matching pages with titles, links and snippets |
| **Find News** | Find recent news articles about a topic |
| **Read a Web Page** | Read one page and get its title and clean text content |

### Search the Web and Find News fields

| Field | Description |
| --- | --- |
| **Search Query** | What to search for, for example `EUR/USD outlook` (required) |
| **Only These Websites** | Comma-separated sites, for example `fxstreet.com, reuters.com` |
| **Time Range** | Only return results from the past day, week, month or year |
| **Number of Results** | How many results to return |
| **Read Full Text of Top Results** | Also read the full text of the top N results, so an AI step can summarize them |
| **Language** | Preferred result language code, for example `en` or `de` |

### Read a Web Page fields

| Field | Description |
| --- | --- |
| **Page URL** | The full address of the page, starting with `https://` (required) |

Every field accepts data mapped from earlier steps.

## Output

Search and news return `results`, each with `title`, `link`, `snippet` and, when available, `content` and `published_date`. Read a Web Page returns `results.title`, `results.content` and `results.link`. Map `content` into an AI step for summaries or analysis.

## Credits

Search and news requests cost one credit each; reading a page costs one additional credit per successfully read page. New accounts receive 100 credits without a credit card. See [Credits and limits](https://s1.dev/docs/essentials/credits-and-limits) for current rates.