---
search:
  tags:
    - Web
    - POST
seo:
  description: >-
    Search the web index populated by /v1/web/crawl. Results are ranked by the
    B/U term score… Reference for the POST /v1/web/search endpoint in the
    Webfold API.
sidebar:
  label: Search the local web index
  badge: POST
title: Search the local web index
type: openapi-operation
---
Search the web index populated by `/v1/web/crawl`. Results are ranked by
the B/U term score over each page.

`POST /v1/web/search`

**Request body** (`application/json`, required)

- `q` (string, required) — Search query
- `n` (integer) — Maximum number of results

Request body example:

```json
{
  "q": "rust webassembly",
  "n": 10
}
```

**Responses**

- `200` — Ranked search results
- `400` — Bad request
- `401` — Missing or invalid bearer token
- `403` — Billing or plan entitlement blocked the request

Response example, 200:

```json
{
  "results": [
    {
      "url": "http://example.com",
      "title": "string",
      "score": 0.1,
      "matches": 0
    }
  ]
}
```