# Search

## Table of Contents

- [Install](#install)
- [Your first query](#your-first-query)
- [Choose the right surface](#choose-the-right-surface)
- [What's next](#whats-next)

---

Microlink Search turns public search surfaces into structured JSON through the [search](https://microlink.io/docs/sdk/methods/search) method of the [Microlink SDK](https://microlink.io/docs/sdk/getting-started/overview).

No HTML parsing, no browser, no proxy fleet to manage. Send a query, get normalized results back. Microlink handles the infrastructure, rotation, and result extraction so your code stays focused on what to do with the data.

## Install

The [microlink.io](https://www.npmjs.com/package/microlink.io) package handles the API call, pagination, and lazy content expansion for you:

```bash
npminstallmicrolink.io
```

## Your first query

Create a client with your [API key](https://dashboard.microlink.io/signup), then query any surface:

```js
importcreateClientfrom'microlink.io'

constmicrolink=createClient({

apiKey:process.env.MICROLINK_API_KEY

})

constpage=awaitmicrolink.search('technical seo checklist')

console.log(page.results[0])

// { title: '...', url: '...', description: '...' }
```

When you omit `type`, the client defaults to web search. The same `microlink.search(query, options)` shape works for every surface, and every example in these guides assumes the `microlink` client above.

## Choose the right surface

Use `type` to route the query to the surface that best matches your workflow:

| If you need                                             | Use                |
| ------------------------------------------------------- | ------------------ |
| Broad web retrieval, knowledge graph, related questions | `search` (default) |
| Recent articles with publisher and date                 | `news`             |
| Image URLs with dimensions                              | `images`           |
| Video metadata with duration                            | `videos`           |
| Local listings with coordinates                         | `places`           |
| Rich place data with hours and ratings                  | `maps`             |
| Product prices and merchant comparison                  | `shopping`         |
| Academic papers and citations                           | `scholar`          |
| Patent filings and prior art                            | `patents`          |
| Query expansion and suggestions                         | `autocomplete`     |

Start with the lightest surface that answers the question. Each surface has its own result shape — see the individual pages below for field references and examples.

## What's next

- **[Web Search](https://microlink.io/docs/guides/search/search)** — knowledge graph, related questions, and related searches.
- **[News](https://microlink.io/docs/guides/search/news)** — articles with publisher, date, and thumbnail.
- **[Images](https://microlink.io/docs/guides/search/images)** — full-resolution URLs with dimensions.
- **[Videos](https://microlink.io/docs/guides/search/videos)** — metadata with duration and channel.
- **[Places](https://microlink.io/docs/guides/search/places)** — local listings with coordinates and contact info.
- **[Maps](https://microlink.io/docs/guides/search/maps)** — rich place data with hours, ratings, and pricing.
- **[Shopping](https://microlink.io/docs/guides/search/shopping)** — parsed prices and structured ratings.
- **[Scholar](https://microlink.io/docs/guides/search/scholar)** — papers, citations, and PDF links.
- **[Patents](https://microlink.io/docs/guides/search/patents)** — filings with dates, figures, and PDF links.
- **[Autocomplete](https://microlink.io/docs/guides/search/autocomplete)** — search suggestions for query expansion.
- **[Content expansion](https://microlink.io/docs/guides/search/content-expansion)** — fetch HTML or Markdown for the results worth reading more deeply.
- **[Integration patterns](https://microlink.io/docs/guides/search/patterns)** — agent tool calling, RAG pipelines, news monitoring, and more.