## Table of Contents

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

---

[API](https://microlink.io/docs/api/getting-started/overview)

[GUIDES](https://microlink.io/docs/guides) [MQL](https://microlink.io/docs/mql/getting-started/overview) [SDK](https://microlink.io/docs/sdk/getting-started/overview) [CARDS](https://microlink.io/docs/cards/getting-started/overview)

API GUIDES MQL SDK CARDS

Getting Started

[Overview](https://microlink.io/docs/guides)

[What is Microlink](https://microlink.io/docs/guides/what-is-microlink)

[Screenshot](https://microlink.io/docs/guides/screenshot)

[Customizing output](https://microlink.io/docs/guides/screenshot/customizing-output)

[Browser settings](https://microlink.io/docs/guides/screenshot/browser-settings)

[Page interaction](https://microlink.io/docs/guides/screenshot/page-interaction)

[Delivery and embedding](https://microlink.io/docs/guides/screenshot/embedding)

[Caching and performance](https://microlink.io/docs/guides/screenshot/caching-and-performance)

[Private pages](https://microlink.io/docs/guides/screenshot/private-pages)

[Troubleshooting](https://microlink.io/docs/guides/screenshot/troubleshooting)

[Data extraction](https://microlink.io/docs/guides/data-extraction)

[Defining rules](https://microlink.io/docs/guides/data-extraction/defining-rules)

[Page preparation](https://microlink.io/docs/guides/data-extraction/page-preparation)

[Delivery and response shaping](https://microlink.io/docs/guides/data-extraction/delivery-and-response)

[Caching and performance](https://microlink.io/docs/guides/data-extraction/caching-and-performance)

[Private pages](https://microlink.io/docs/guides/data-extraction/private-pages)

[Troubleshooting](https://microlink.io/docs/guides/data-extraction/troubleshooting)

[Embed](https://microlink.io/docs/guides/embed)

[SDK](https://microlink.io/docs/guides/embed/sdk)

[Iframe parameter](https://microlink.io/docs/guides/embed/iframe)

[Custom HTML/CSS](https://microlink.io/docs/guides/embed/metadata-api)

[Custom previews with AI](https://microlink.io/docs/guides/embed/custom-previews-with-ai)

[Caching and performance](https://microlink.io/docs/guides/embed/caching-and-performance)

[Private pages and proxy](https://microlink.io/docs/guides/embed/private-pages-and-proxy)

[Troubleshooting](https://microlink.io/docs/guides/embed/troubleshooting)

[Markdown](https://microlink.io/docs/guides/markdown)

[Choosing scope](https://microlink.io/docs/guides/markdown/choosing-scope)

[Delivery and response shaping](https://microlink.io/docs/guides/markdown/delivery-and-response)

[Function](https://microlink.io/docs/guides/function)

[Writing functions](https://microlink.io/docs/guides/function/writing-functions)

[Browser interaction](https://microlink.io/docs/guides/function/browser-interaction)

[Profiling and performance](https://microlink.io/docs/guides/function/profiling-and-performance)

[Troubleshooting](https://microlink.io/docs/guides/function/troubleshooting)

[PDF](https://microlink.io/docs/guides/pdf)

[Page size and layout](https://microlink.io/docs/guides/pdf/page-size-and-layout)

[Page preparation](https://microlink.io/docs/guides/pdf/page-preparation)

[Delivery and embedding](https://microlink.io/docs/guides/pdf/embedding)

[Caching and performance](https://microlink.io/docs/guides/pdf/caching-and-performance)

[Private pages](https://microlink.io/docs/guides/pdf/private-pages)

[Troubleshooting](https://microlink.io/docs/guides/pdf/troubleshooting)

[Metadata](https://microlink.io/docs/guides/metadata)

[Choosing fields](https://microlink.io/docs/guides/metadata/choosing-fields)

[Extending results](https://microlink.io/docs/guides/metadata/extending-results)

[Delivery and response shaping](https://microlink.io/docs/guides/metadata/delivery-and-response)

[Page preparation](https://microlink.io/docs/guides/metadata/page-preparation)

[Caching and performance](https://microlink.io/docs/guides/metadata/caching-and-performance)

[Private pages](https://microlink.io/docs/guides/metadata/private-pages)

[Troubleshooting](https://microlink.io/docs/guides/metadata/troubleshooting)

[Insights](https://microlink.io/docs/guides/insights)

[Technology detection](https://microlink.io/docs/guides/insights/technology-detection)

[Lighthouse reports](https://microlink.io/docs/guides/insights/lighthouse-reports)

[Caching and performance](https://microlink.io/docs/guides/insights/caching-and-performance)

[Troubleshooting](https://microlink.io/docs/guides/insights/troubleshooting)

[Search](https://microlink.io/docs/guides/search)

[Web Search](https://microlink.io/docs/guides/search/search)

[News](https://microlink.io/docs/guides/search/news)

[Images](https://microlink.io/docs/guides/search/images)

[Videos](https://microlink.io/docs/guides/search/videos)

[Places](https://microlink.io/docs/guides/search/places)

[Maps](https://microlink.io/docs/guides/search/maps)

[Shopping](https://microlink.io/docs/guides/search/shopping)

[Scholar](https://microlink.io/docs/guides/search/scholar)

[Patents](https://microlink.io/docs/guides/search/patents)

[Autocomplete](https://microlink.io/docs/guides/search/autocomplete)

[Content expansion](https://microlink.io/docs/guides/search/content-expansion)

[Integration patterns](https://microlink.io/docs/guides/search/patterns)

[Common patterns](https://microlink.io/docs/guides/common/caching)

[Caching patterns](https://microlink.io/docs/guides/common/caching)

[Private pages](https://microlink.io/docs/guides/common/private-pages)

[Proxy](https://microlink.io/docs/guides/common/proxy)

[Troubleshooting](https://microlink.io/docs/guides/common/troubleshooting)

[Production patterns](https://microlink.io/docs/guides/common/production-patterns)

API GUIDES MQL SDK CARDS

Getting Started

[Overview](https://microlink.io/docs/guides)

[What is Microlink](https://microlink.io/docs/guides/what-is-microlink)

[Screenshot](https://microlink.io/docs/guides/screenshot)

[Customizing output](https://microlink.io/docs/guides/screenshot/customizing-output)

[Browser settings](https://microlink.io/docs/guides/screenshot/browser-settings)

[Page interaction](https://microlink.io/docs/guides/screenshot/page-interaction)

[Delivery and embedding](https://microlink.io/docs/guides/screenshot/embedding)

[Caching and performance](https://microlink.io/docs/guides/screenshot/caching-and-performance)

[Private pages](https://microlink.io/docs/guides/screenshot/private-pages)

[Troubleshooting](https://microlink.io/docs/guides/screenshot/troubleshooting)

[Data extraction](https://microlink.io/docs/guides/data-extraction)

[Defining rules](https://microlink.io/docs/guides/data-extraction/defining-rules)

[Page preparation](https://microlink.io/docs/guides/data-extraction/page-preparation)

[Delivery and response shaping](https://microlink.io/docs/guides/data-extraction/delivery-and-response)

[Caching and performance](https://microlink.io/docs/guides/data-extraction/caching-and-performance)

[Private pages](https://microlink.io/docs/guides/data-extraction/private-pages)

[Troubleshooting](https://microlink.io/docs/guides/data-extraction/troubleshooting)

[Embed](https://microlink.io/docs/guides/embed)

[SDK](https://microlink.io/docs/guides/embed/sdk)

[Iframe parameter](https://microlink.io/docs/guides/embed/iframe)

[Custom HTML/CSS](https://microlink.io/docs/guides/embed/metadata-api)

[Custom previews with AI](https://microlink.io/docs/guides/embed/custom-previews-with-ai)

[Caching and performance](https://microlink.io/docs/guides/embed/caching-and-performance)

[Private pages and proxy](https://microlink.io/docs/guides/embed/private-pages-and-proxy)

[Troubleshooting](https://microlink.io/docs/guides/embed/troubleshooting)

[Markdown](https://microlink.io/docs/guides/markdown)

[Choosing scope](https://microlink.io/docs/guides/markdown/choosing-scope)

[Delivery and response shaping](https://microlink.io/docs/guides/markdown/delivery-and-response)

[Function](https://microlink.io/docs/guides/function)

[Writing functions](https://microlink.io/docs/guides/function/writing-functions)

[Browser interaction](https://microlink.io/docs/guides/function/browser-interaction)

[Profiling and performance](https://microlink.io/docs/guides/function/profiling-and-performance)

[Troubleshooting](https://microlink.io/docs/guides/function/troubleshooting)

[PDF](https://microlink.io/docs/guides/pdf)

[Page size and layout](https://microlink.io/docs/guides/pdf/page-size-and-layout)

[Page preparation](https://microlink.io/docs/guides/pdf/page-preparation)

[Delivery and embedding](https://microlink.io/docs/guides/pdf/embedding)

[Caching and performance](https://microlink.io/docs/guides/pdf/caching-and-performance)

[Private pages](https://microlink.io/docs/guides/pdf/private-pages)

[Troubleshooting](https://microlink.io/docs/guides/pdf/troubleshooting)

[Metadata](https://microlink.io/docs/guides/metadata)

[Choosing fields](https://microlink.io/docs/guides/metadata/choosing-fields)

[Extending results](https://microlink.io/docs/guides/metadata/extending-results)

[Delivery and response shaping](https://microlink.io/docs/guides/metadata/delivery-and-response)

[Page preparation](https://microlink.io/docs/guides/metadata/page-preparation)

[Caching and performance](https://microlink.io/docs/guides/metadata/caching-and-performance)

[Private pages](https://microlink.io/docs/guides/metadata/private-pages)

[Troubleshooting](https://microlink.io/docs/guides/metadata/troubleshooting)

[Insights](https://microlink.io/docs/guides/insights)

[Technology detection](https://microlink.io/docs/guides/insights/technology-detection)

[Lighthouse reports](https://microlink.io/docs/guides/insights/lighthouse-reports)

[Caching and performance](https://microlink.io/docs/guides/insights/caching-and-performance)

[Troubleshooting](https://microlink.io/docs/guides/insights/troubleshooting)

[Search](https://microlink.io/docs/guides/search)

[Web Search](https://microlink.io/docs/guides/search/search)

[News](https://microlink.io/docs/guides/search/news)

[Images](https://microlink.io/docs/guides/search/images)

[Videos](https://microlink.io/docs/guides/search/videos)

[Places](https://microlink.io/docs/guides/search/places)

[Maps](https://microlink.io/docs/guides/search/maps)

[Shopping](https://microlink.io/docs/guides/search/shopping)

[Scholar](https://microlink.io/docs/guides/search/scholar)

[Patents](https://microlink.io/docs/guides/search/patents)

[Autocomplete](https://microlink.io/docs/guides/search/autocomplete)

[Content expansion](https://microlink.io/docs/guides/search/content-expansion)

[Integration patterns](https://microlink.io/docs/guides/search/patterns)

[Common patterns](https://microlink.io/docs/guides/common/caching)

[Caching patterns](https://microlink.io/docs/guides/common/caching)

[Private pages](https://microlink.io/docs/guides/common/private-pages)

[Proxy](https://microlink.io/docs/guides/common/proxy)

[Troubleshooting](https://microlink.io/docs/guides/common/troubleshooting)

[Production patterns](https://microlink.io/docs/guides/common/production-patterns)

## SearchPRO

[Copy for LLM](https://microlink.io/docs/guides/search.md "Copy content for LLM")

\|

[View as Markdown](https://microlink.io/docs/guides/search.md "View content as Markdown")

Microlink Search turns public search surfaces into structured JSON through the

[`@microlink/google`](https://www.npmjs.com/package/@microlink/google)

Node.js client.

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/google](https://www.npmjs.com/package/@microlink/google)

library handles the API call, pagination, and lazy content expansion for you:

```bash
npm install @microlink/google
```

## Your first query

Create a client with your

[API key](https://microlink.io/#pricing)

, then query any surface:

```js
import createGoogleClient from '@microlink/google'

const google = createGoogleClient({

  apiKey: process.env.MICROLINK_API_KEY

})

const page = await google('technical seo checklist')

console.log(page.results[0])

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

When you omit `type`, the client defaults to web search. The same `google(query, options)` shape works for every surface.

## 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.

Last updated on May 28, 2026

[Edit on GitHub](https://github.com/microlinkhq/www/blob/master/src/content/docs/guides/search/index.md)