> ## 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/proposals/search

> Search and list Snapshot governance proposals by keyword, space, author, state, type and date ranges

**Price:** 1 credit

**💡 AI Hint:** Search and list Snapshot off-chain governance proposals. Match a keyword against the proposal title, and filter by space ids, author addresses, lifecycle state (active, pending, closed), voting type, network, flagged status, score state, and created/start/end date ranges; sort by created, start, end, vote count, or total score. Each proposal includes the title, body text, choices, scores, voting type, state, quorum, strategies, space, author address, vote count, and timestamps.



## OpenAPI

````yaml /openapi-filtered.json post /api/snapshot/proposals/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/proposals/search:
    post:
      tags:
        - /snapshot
      summary: /snapshot/proposals/search
      description: >-
        Search and list Snapshot governance proposals by keyword, space, author,
        state, type and date ranges


        **Price:** 1 credit


        **💡 AI Hint:** Search and list Snapshot off-chain governance proposals.
        Match a keyword against the proposal title, and filter by space ids,
        author addresses, lifecycle state (active, pending, closed), voting
        type, network, flagged status, score state, and created/start/end date
        ranges; sort by created, start, end, vote count, or total score. Each
        proposal includes the title, body text, choices, scores, voting type,
        state, quorum, strategies, space, author address, vote count, and
        timestamps.
      operationId: __api_snapshot_proposals_search_post
      parameters:
        - name: access-token
          in: header
          required: true
          schema:
            anyOf:
              - type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SnapshotProposalsSearchPayload'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SnapshotProposal'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    SnapshotProposalsSearchPayload:
      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 proposals to return
        query:
          anyOf:
            - type: string
              minLength: 1
            - type: 'null'
          description: Keyword to match against the proposal title
          examples:
            - treasury
        space:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          description: Filter by one or more space ids
          examples:
            - - ens.eth
            - - aave.eth
              - uniswapgovernance.eth
        state:
          $ref: '#/components/schemas/SnapshotProposalState'
          description: Filter by proposal lifecycle state
          default: all
        author:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          description: Filter by one or more author wallet addresses
        type:
          anyOf:
            - $ref: '#/components/schemas/SnapshotProposalType'
            - type: 'null'
          description: Filter by voting type
        network:
          anyOf:
            - type: string
            - type: 'null'
          description: Filter by network chain id
          examples:
            - '1'
            - '137'
            - '42161'
        flagged:
          anyOf:
            - type: boolean
            - type: 'null'
          description: Filter by flagged (spam) status
        scores_state:
          anyOf:
            - $ref: '#/components/schemas/SnapshotScoresState'
            - type: 'null'
          description: Filter by score computation state
        created_after:
          anyOf:
            - type: integer
            - type: 'null'
          description: Only proposals created after this unix timestamp
        created_before:
          anyOf:
            - type: integer
            - type: 'null'
          description: Only proposals created before this unix timestamp
        start_after:
          anyOf:
            - type: integer
            - type: 'null'
          description: Only proposals whose voting starts after this unix timestamp
        start_before:
          anyOf:
            - type: integer
            - type: 'null'
          description: Only proposals whose voting starts before this unix timestamp
        end_after:
          anyOf:
            - type: integer
            - type: 'null'
          description: Only proposals whose voting ends after this unix timestamp
        end_before:
          anyOf:
            - type: integer
            - type: 'null'
          description: Only proposals whose voting ends before this unix timestamp
        order:
          $ref: '#/components/schemas/SnapshotProposalOrder'
          description: Sort field
          default: created
        ascending:
          type: boolean
          description: Sort ascending instead of descending
          default: false
      type: object
      required:
        - count
    SnapshotProposal:
      properties:
        '@type':
          type: string
          default: SnapshotProposal
        id:
          type: string
        ipfs:
          anyOf:
            - type: string
            - type: 'null'
        author:
          anyOf:
            - type: string
            - type: 'null'
        space:
          anyOf:
            - $ref: '#/components/schemas/SnapshotSpaceRef'
            - type: 'null'
        text:
          anyOf:
            - type: string
            - type: 'null'
        discussion_url:
          anyOf:
            - type: string
            - type: 'null'
        web_url:
          anyOf:
            - type: string
            - type: 'null'
        app:
          anyOf:
            - type: string
            - type: 'null'
        type:
          anyOf:
            - type: string
            - type: 'null'
        state:
          anyOf:
            - type: string
            - type: 'null'
        privacy:
          anyOf:
            - type: string
            - type: 'null'
        network:
          anyOf:
            - type: string
            - type: 'null'
        symbol:
          anyOf:
            - type: string
            - type: 'null'
        choices:
          items:
            type: string
          type: array
          default: []
        quorum:
          anyOf:
            - type: number
            - type: 'null'
        quorum_type:
          anyOf:
            - type: string
            - type: 'null'
        snapshot_block:
          anyOf:
            - type: string
            - type: 'null'
        scores:
          items:
            type: number
          type: array
          default: []
        scores_by_strategy:
          items: {}
          type: array
          default: []
        scores_total:
          anyOf:
            - type: number
            - type: 'null'
        scores_total_value:
          anyOf:
            - type: number
            - type: 'null'
        vp_value_by_strategy:
          items:
            type: number
          type: array
          default: []
        scores_state:
          anyOf:
            - type: string
            - type: 'null'
        scores_updated_at:
          anyOf:
            - type: integer
            - type: 'null'
        vote_count:
          anyOf:
            - type: integer
            - type: 'null'
        is_flagged:
          anyOf:
            - type: boolean
            - type: 'null'
        strategies:
          items:
            $ref: '#/components/schemas/SnapshotStrategyRef'
          type: array
          default: []
        validation:
          anyOf:
            - $ref: '#/components/schemas/SnapshotSpaceValidation'
            - type: 'null'
        plugins:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
        created_at:
          anyOf:
            - type: integer
            - type: 'null'
        updated_at:
          anyOf:
            - type: integer
            - type: 'null'
        start_at:
          anyOf:
            - type: integer
            - type: 'null'
        end_at:
          anyOf:
            - type: integer
            - type: 'null'
      type: object
      required:
        - id
        - title
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
      type: object
    SnapshotProposalState:
      type: string
      enum:
        - active
        - pending
        - closed
        - all
    SnapshotProposalType:
      type: string
      enum:
        - single-choice
        - approval
        - quadratic
        - ranked-choice
        - weighted
        - basic
    SnapshotScoresState:
      type: string
      enum:
        - pending
        - final
        - invalid
    SnapshotProposalOrder:
      type: string
      enum:
        - created
        - start
        - end
        - votes
        - scores_total
    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
    SnapshotStrategyRef:
      properties:
        '@type':
          type: string
          default: SnapshotStrategyRef
        name:
          type: string
        network:
          anyOf:
            - type: string
            - type: 'null'
        params:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
      type: object
      required:
        - name
    SnapshotSpaceValidation:
      properties:
        '@type':
          type: string
          default: SnapshotSpaceValidation
        name:
          type: string
        params:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
      type: object
      required:
        - name
    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

````