# BlockRun.AI Find Similar Pages

> BlockRun.AI Find Similar Pages is a paid API for AI agents from blockrun.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns a list of web pages that are semantically similar to a given reference URL, using Exa's similarity search.

## Facts

- Endpoint: POST https://blockrun.ai/api/v1/exa/find-similar
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockrun-ai-c6bb7422
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_d6xW1IPqvL-sV-54t0_oM

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability blockrun-ai-c6bb7422 -d '<json body>'
```

Example prompt: Find me 15 web pages that are semantically similar to https://vitalik.eth.limo/general/2024/01/01/end.html — I want to discover related content on that topic.

## When to prefer this

Use this endpoint when you need to discover web pages topically or semantically related to a known URL — ideal for content research, competitive analysis, finding related articles, or building recommendation feeds. Prefer this over a keyword search when you have a reference page and want conceptually similar content rather than keyword matches.

## Known failure modes

- Invalid or unreachable URL returns an error or empty results
- numResults exceeding 100 may be rejected or capped
- URL pointing to paywalled or non-indexed content may yield poor similarity matches
- Payment failure via x402 protocol returns 402 status
- Malformed request body returns 400 validation error

## How this service works

Find pages semantically similar to a given URL.

## Output

A list of web pages semantically similar to the input URL, including page titles, URLs, and relevance metadata, up to the requested number of results (default 10, max 100).

## Example request

```json
{
 "url": "https://example.com/article-about-artificial-intelligence",
 "numResults": 10
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "description": "Reference URL — pages similar to this will be returned."
  },
  "numResults": {
   "type": "number",
   "description": "Number of results to return (default 10, max 100)."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockrun-ai-c6bb7422/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from blockrun.ai](https://www.zero.xyz/host/blockrun.ai/llms.txt)