# Blockscout Multichain Metadata Tags Search

> Blockscout Multichain Metadata Tags Search is a paid API for AI agents from api.blockscout.com, paid per call via x402, $0.012/call, status unknown (last checked 2026-09-15).

Search and retrieve blockchain address tags and metadata across multiple chains by name, type, or chain ID

## Facts

- Endpoint: GET https://api.blockscout.com/services/metadata/api/v1/tags:search
- Price: $0.012/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockscout-multichain-metadata-tags-search-985d9de2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5JuuLVz8Zd5pmfVKBnfiT

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-multichain-metadata-tags-search-985d9de2
```

Example prompt: Search Blockscout's multichain metadata for tags named 'Uniswap' on Ethereum (chain ID 1), returning up to 10 results with their associated addresses.

## When to prefer this

Use this endpoint when you need to find curated metadata labels (tags) attached to blockchain addresses across multiple networks — especially when you know a protocol or entity name and want to discover its associated contract addresses. Prefer this over raw transaction search when the goal is entity identification or address labeling rather than transaction history.

## Known failure modes

- Empty items array if no tags match the query name or filters
- Invalid chain_id returns no results or an error response
- Malformed tag_types parameter may be silently ignored or return unfiltered results
- Pagination token mismatch causes repeated or missing results
- Rate limiting or payment failure returns 402 or 429 status

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

Returns a paginated list of tag objects, each containing a tag name, slug, type, ordinal ranking, and associated blockchain addresses, along with a nextPageParams object containing pageSize and pageToken for fetching subsequent pages.

## 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"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "name": {
       "type": "string"
      },
      "chain_id": {
       "type": "string"
      },
      "page_size": {
       "type": "integer"
      },
      "tag_types": {
       "type": "string"
      },
      "page_token": {
       "type": "string"
      },
      "address_limit": {
       "type": "integer"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "tag": {
     "meta": "string",
     "name": "string",
     "slug": "string",
     "ordinal": 0,
     "tagType": "string"
    },
    "addresses": [
     "string"
    ]
   }
  ],
  "nextPageParams": {
   "pageSize": 0,
   "pageToken": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockscout-multichain-metadata-tags-search-985d9de2/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)