---
title: "Web search"
method: POST
path: "/api/v1/search"
tags: ["Data"]
---

# Web search

`POST /api/v1/search`

## Request

- Base URL: `https://core.blink.new`
- URL: `https://core.blink.new/api/v1/search`
- Auth: HTTP bearer

Perform a Google web search and return structured organic results. Billed per query under `data:search`. Pass `x-blink-agent-id` to attribute usage to a specific agent.

## Request body

- object
  - `query` string, required: Search terms.
  - `count` integer: Results to return, capped at 10.

## Response `200`

Search completed — returns organic results

- object
  - `query` string: Trimmed query that was executed
  - `count` integer: Number of results returned
  - `results` object[]
    - `title` string: Page title
    - `url` string, uri: Page URL
    - `description` string: Result snippet
    - `published` string: Publication date (when available)

## Other responses

- `400`: Missing or empty `query`
- `401`: Authentication required or invalid API key
- `500`: Search service not configured or provider error
- `502`: Value SERP provider returned an error

---

[API](https://skmtc.dev/blink/apis/blink-apis.md) - [All operations](https://skmtc.dev/blink/apis/blink-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/blink/apis/blink-apis/revisions/4c59c706078e?raw)