> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockscout.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Search for tokens, addresses, contracts, blocks, or transactions by identifier

> Performs a unified search across multiple blockchain entity types including tokens, addresses, contracts, blocks, transactions and other resources.



## OpenAPI

````yaml /openapi-specs/pro-api-v11.yaml get /v2/search
openapi: 3.0.0
info:
  contact:
    email: info@blockscout.com
  title: Blockscout
  version: 11.0.3
servers:
  - url: http://localhost/api
    variables: {}
security: []
tags:
  - name: blocks
  - name: transactions
  - name: addresses
  - name: internal-transactions
  - name: tokens
  - name: token-transfers
  - name: smart-contracts
  - name: config
  - name: main-page
  - name: search
  - name: stats
  - name: csv-export
  - name: account-abstraction
  - name: withdrawals
  - name: advanced-filters
  - name: arbitrum
  - name: legacy
  - name: optimism
  - name: mud
  - name: celo
  - name: scroll
  - name: zilliqa
paths:
  /v2/search:
    get:
      tags:
        - search
      summary: >-
        Search for tokens, addresses, contracts, blocks, or transactions by
        identifier
      description: >-
        Performs a unified search across multiple blockchain entity types
        including tokens, addresses, contracts, blocks, transactions and other
        resources.
      operationId: BlockScoutWeb.API.V2.SearchController.search (2)
      parameters:
        - description: Search query filter
          in: query
          name: q
          required: false
          schema:
            nullable: true
            type: string
            x-struct: null
            x-validate: null
        - description: API key for rate limiting or for sensitive endpoints
          in: query
          name: apikey
          required: false
          schema:
            type: string
            x-struct: null
            x-validate: null
        - description: Secret key for getting access to restricted resources
          in: query
          name: key
          required: false
          schema:
            type: string
            x-struct: null
            x-validate: null
        - description: Next page params type for paging
          in: query
          name: next_page_params_type
          required: false
          schema:
            type: string
            x-struct: null
            x-validate: null
        - description: Label for paging in the search results
          in: query
          name: label
          required: false
          schema:
            type: object
            x-struct: null
            x-validate: null
        - description: Token for paging in the search results
          in: query
          name: token
          required: false
          schema:
            type: object
            x-struct: null
            x-validate: null
        - description: Contract for paging in the search results
          in: query
          name: contract
          required: false
          schema:
            type: object
            x-struct: null
            x-validate: null
        - description: TAC operation for paging in the search results
          in: query
          name: tac_operation
          required: false
          schema:
            type: object
            x-struct: null
            x-validate: null
        - description: Metadata tag for paging in the search results
          in: query
          name: metadata_tag
          required: false
          schema:
            type: object
            x-struct: null
            x-validate: null
        - description: Block for paging in the search results
          in: query
          name: block
          required: false
          schema:
            type: object
            x-struct: null
            x-validate: null
        - description: Blob for paging in the search results
          in: query
          name: blob
          required: false
          schema:
            type: object
            x-struct: null
            x-validate: null
        - description: User operation for paging in the search results
          in: query
          name: user_operation
          required: false
          schema:
            type: object
            x-struct: null
            x-validate: null
        - description: Address for paging in the search results
          in: query
          name: address
          required: false
          schema:
            type: object
            x-struct: null
            x-validate: null
        - description: ENS domain for paging in the search results
          in: query
          name: ens_domain
          required: false
          schema:
            type: object
            x-struct: null
            x-validate: null
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SearchResult'
          description: >-
            Successful search response containing matched items and pagination
            information.
                        Results are ordered by relevance and limited to 50 items per page.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonErrorResponse'
          description: Unprocessable Entity
      callbacks: {}
components:
  schemas:
    SearchResult:
      description: Search results containing blocks, transactions, and addresses
      properties:
        items:
          items:
            type: object
            x-struct: null
            x-validate: null
          type: array
          x-struct: null
          x-validate: null
        next_page_params:
          nullable: true
          type: object
          x-struct: null
          x-validate: null
      title: SearchResult
      type: object
      x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.Search.Results
      x-validate: null
    JsonErrorResponse:
      properties:
        errors:
          items:
            properties:
              detail:
                example: null value where string expected
                type: string
                x-struct: null
                x-validate: null
              source:
                properties:
                  pointer:
                    example: /data/attributes/petName
                    type: string
                    x-struct: null
                    x-validate: null
                required:
                  - pointer
                type: object
                x-struct: null
                x-validate: null
              title:
                example: Invalid value
                type: string
                x-struct: null
                x-validate: null
            required:
              - title
              - source
              - detail
            type: object
            x-struct: null
            x-validate: null
          type: array
          x-struct: null
          x-validate: null
      required:
        - errors
      title: JsonErrorResponse
      type: object
      x-struct: Elixir.OpenApiSpex.JsonErrorResponse
      x-validate: null

````