# Blockscout Search Redirect Check

> Blockscout Search Redirect Check is a paid API for AI agents from api.blockscout.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-12).

Checks whether a blockchain search query on a specific chain should redirect to a direct result page, returning the redirect target type and parameter

## Facts

- Endpoint: GET https://api.blockscout.com/%7Bchain_id%7D/api/v2/search/check-redirect
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockscout-search-redirect-check-1b636bc9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_aShlb0vhJQlWMqHcf1xZR

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 blockscout-search-redirect-check-1b636bc9
```

Example prompt: On the Ethereum chain (chain ID 1), check if searching for '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045' on Blockscout would redirect directly to an address or transaction page, and tell me what type of result it maps to.

## When to prefer this

Use this endpoint when you need to determine programmatically whether a user's search query on a specific blockchain network maps directly to a known entity (address, tx, token, block) and can be navigated to without showing a results list. Prefer this over a full search when you want to short-circuit a lookup and deep-link into the Blockscout explorer. Particularly useful in agent workflows that resolve blockchain entities before presenting them to the user.

## Known failure modes

- Invalid or unsupported chain_id returns an error or empty response
- Empty query string 'q' returns no redirect and no type
- Query that matches no known entity returns redirect: false with no parameter
- Payment not included or insufficient USDC results in 402 Payment Required
- Network timeout or Blockscout node unavailability returns 5xx error

## How this service works

Explore crypto activities with Blockscout's multichain search. Find transactions, addresses, tokens, and dapps across top blockchain networks — your go-to explorer for cross-chain blockchain data

## Output

A JSON object containing: a 'type' string indicating the kind of entity matched (e.g. 'address', 'transaction', 'block', 'token'), a 'redirect' boolean indicating whether the query should redirect directly rather than show a search list, and a 'parameter' string with the redirect target identifier.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "properties": {
      "chain_id": {
       "type": "string"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "q": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "type": "string",
  "redirect": true,
  "parameter": "string"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockscout-search-redirect-check-1b636bc9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.blockscout.com](https://www.zero.xyz/host/api.blockscout.com/llms.txt)