Skip to main content
POST
/
api
/
snapshot
/
proposals
/
search
/snapshot/proposals/search
curl --request POST \
  --url https://api.anysite.io/api/snapshot/proposals/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 2,
  "timeout": 300,
  "query": "treasury",
  "space": [
    "ens.eth"
  ],
  "state": "all",
  "author": [
    "<string>"
  ],
  "network": "1",
  "flagged": true,
  "created_after": 123,
  "created_before": 123,
  "start_after": 123,
  "start_before": 123,
  "end_after": 123,
  "end_before": 123,
  "order": "created",
  "ascending": false
}
'
[
  {
    "id": "<string>",
    "@type": "SnapshotProposal",
    "ipfs": "<string>",
    "author": "<string>",
    "space": {
      "id": "<string>",
      "@type": "SnapshotSpaceRef",
      "name": "<string>",
      "image": "<string>",
      "network": "<string>"
    },
    "text": "<string>",
    "discussion_url": "<string>",
    "web_url": "<string>",
    "app": "<string>",
    "type": "<string>",
    "state": "<string>",
    "privacy": "<string>",
    "network": "<string>",
    "symbol": "<string>",
    "choices": [],
    "quorum": 123,
    "quorum_type": "<string>",
    "snapshot_block": "<string>",
    "scores": [],
    "scores_by_strategy": [],
    "scores_total": 123,
    "scores_total_value": 123,
    "vp_value_by_strategy": [],
    "scores_state": "<string>",
    "scores_updated_at": 123,
    "vote_count": 123,
    "is_flagged": true,
    "strategies": [],
    "validation": {
      "name": "<string>",
      "@type": "SnapshotSpaceValidation",
      "params": {}
    },
    "plugins": {},
    "created_at": 123,
    "updated_at": 123,
    "start_at": 123,
    "end_at": 123
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
count
integer
required

Max number of proposals to return

Required range: x >= 1
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
query
string | null

Keyword to match against the proposal title

Minimum string length: 1
Example:

"treasury"

space
string[] | null

Filter by one or more space ids

Example:
["ens.eth"]
state
enum<string>
default:all

Filter by proposal lifecycle state

Available options:
active,
pending,
closed,
all
author
string[] | null

Filter by one or more author wallet addresses

type
enum<string> | null

Filter by voting type

Available options:
single-choice,
approval,
quadratic,
ranked-choice,
weighted,
basic
network
string | null

Filter by network chain id

Example:

"1"

flagged
boolean | null

Filter by flagged (spam) status

scores_state
enum<string> | null

Filter by score computation state

Available options:
pending,
final,
invalid
created_after
integer | null

Only proposals created after this unix timestamp

created_before
integer | null

Only proposals created before this unix timestamp

start_after
integer | null

Only proposals whose voting starts after this unix timestamp

start_before
integer | null

Only proposals whose voting starts before this unix timestamp

end_after
integer | null

Only proposals whose voting ends after this unix timestamp

end_before
integer | null

Only proposals whose voting ends before this unix timestamp

order
enum<string>
default:created

Sort field

Available options:
created,
start,
end,
votes,
scores_total
ascending
boolean
default:false

Sort ascending instead of descending

Response

Successful Response

id
string
required
@type
string
default:SnapshotProposal
ipfs
string | null
author
string | null
space
object
text
string | null
discussion_url
string | null
web_url
string | null
app
string | null
type
string | null
state
string | null
privacy
string | null
network
string | null
symbol
string | null
choices
string[]
quorum
number | null
quorum_type
string | null
snapshot_block
string | null
scores
number[]
scores_by_strategy
any[]
scores_total
number | null
scores_total_value
number | null
vp_value_by_strategy
number[]
scores_state
string | null
scores_updated_at
integer | null
vote_count
integer | null
is_flagged
boolean | null
strategies
object[]
validation
object
plugins
object
created_at
integer | null
updated_at
integer | null
start_at
integer | null
end_at
integer | null