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

# /snapshot/votes/search

> Search and list Snapshot votes by proposal, voter address, or space

**Price:** 1 credit

**💡 AI Hint:** Search and list individual Snapshot votes. Filter by a proposal id to get every vote cast on one proposal, by one or more voter addresses to get a voter's history, or by space; optionally narrow by a created-time range. Sort by created time or voting power. Each vote includes the voter address, the choice made, the voting power (total and per strategy), an optional reason, and the proposal and space it belongs to.



## OpenAPI

````yaml /openapi-filtered.json post /api/snapshot/votes/search
openapi: 3.1.0
info:
  title: Any Site API
  description: >+
    Any Site API provides programmatic access to data from LinkedIn, Instagram,
    Twitter, and other platforms.


    ## Authentication


    All API endpoints require an `access-token` header with a valid API token.
    Tokens can be created in the [dashboard](https://app.anysite.io/).


    ## Pricing


    Each endpoint has a credit cost listed in its description. Credits are
    deducted from your token balance per request.

  version: 0.0.1
servers: []
security:
  - AccessToken: []
paths:
  /api/snapshot/votes/search:
    post:
      tags:
        - /snapshot
      summary: /snapshot/votes/search
      description: >-
        Search and list Snapshot votes by proposal, voter address, or space


        **Price:** 1 credit


        **💡 AI Hint:** Search and list individual Snapshot votes. Filter by a
        proposal id to get every vote cast on one proposal, by one or more voter
        addresses to get a voter's history, or by space; optionally narrow by a
        created-time range. Sort by created time or voting power. Each vote
        includes the voter address, the choice made, the voting power (total and
        per strategy), an optional reason, and the proposal and space it belongs
        to.
      operationId: __api_snapshot_votes_search_post
      parameters:
        - name: access-token
          in: header
          required: true
          schema:
            anyOf:
              - type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SnapshotVotesSearchPayload'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SnapshotVote'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    SnapshotVotesSearchPayload:
      properties:
        timeout:
          type: integer
          maximum: 1500
          minimum: 20
          description: Max scrapping execution timeout (in seconds)
          default: 300
        count:
          type: integer
          minimum: 1
          description: Max number of votes to return
        proposal:
          anyOf:
            - type: string
              minLength: 1
            - type: 'null'
          description: Filter by proposal id (all votes cast on one proposal)
        proposal_in:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          description: Filter by several proposal ids at once
        voter:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          description: >-
            Filter by one or more voter wallet addresses (a voter's voting
            history)
        space:
          anyOf:
            - type: string
            - type: 'null'
          description: Filter by space id
          examples:
            - ens.eth
        created_after:
          anyOf:
            - type: integer
            - type: 'null'
          description: Only votes cast after this unix timestamp
        created_before:
          anyOf:
            - type: integer
            - type: 'null'
          description: Only votes cast before this unix timestamp
        vp_min:
          anyOf:
            - type: number
            - type: 'null'
          description: Only votes with voting power greater than this
        vp_max:
          anyOf:
            - type: number
            - type: 'null'
          description: Only votes with voting power less than this
        order:
          $ref: '#/components/schemas/SnapshotVoteOrder'
          description: Sort field
          default: created
        ascending:
          type: boolean
          description: Sort ascending instead of descending
          default: false
      type: object
      required:
        - count
    SnapshotVote:
      properties:
        '@type':
          type: string
          default: SnapshotVote
        id:
          type: string
        ipfs:
          anyOf:
            - type: string
            - type: 'null'
        voter:
          anyOf:
            - type: string
            - type: 'null'
        choice:
          anyOf:
            - type: integer
            - type: number
            - items: {}
              type: array
            - additionalProperties: true
              type: object
            - type: 'null'
        reason:
          anyOf:
            - type: string
            - type: 'null'
        vp:
          anyOf:
            - type: number
            - type: 'null'
        vp_value:
          anyOf:
            - type: number
            - type: 'null'
        vp_by_strategy:
          items:
            type: number
          type: array
          default: []
        vp_state:
          anyOf:
            - type: string
            - type: 'null'
        metadata:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
        proposal:
          anyOf:
            - $ref: '#/components/schemas/SnapshotProposalRef'
            - type: 'null'
        space:
          anyOf:
            - $ref: '#/components/schemas/SnapshotSpaceRef'
            - type: 'null'
        created_at:
          anyOf:
            - type: integer
            - type: 'null'
      type: object
      required:
        - id
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
      type: object
    SnapshotVoteOrder:
      type: string
      enum:
        - created
        - vp
    SnapshotProposalRef:
      properties:
        '@type':
          type: string
          default: SnapshotProposalRef
        id:
          type: string
        state:
          anyOf:
            - type: string
            - type: 'null'
      type: object
      required:
        - id
    SnapshotSpaceRef:
      properties:
        '@type':
          type: string
          default: SnapshotSpaceRef
        id:
          type: string
        name:
          anyOf:
            - type: string
            - type: 'null'
        image:
          anyOf:
            - type: string
            - type: 'null'
        network:
          anyOf:
            - type: string
            - type: 'null'
      type: object
      required:
        - id
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
        msg:
          type: string
        type:
          type: string
        input: {}
        ctx:
          type: object
      type: object
      required:
        - loc
        - msg
        - type
  securitySchemes:
    AccessToken:
      type: apiKey
      in: header
      name: access-token
      description: API token from the dashboard

````