Search

Airdrop Search

Searches and filters airdrop opportunities.

Filters: keyword, status, reward type, task type.

Returns paginated results with optional task details.

get/gateway/v1/search/airdrop

Request

  • Base URL
    https://api.asksurf.ai
  • Auth
    HTTP bearer

Query parameters

qstring

Search keyword for coin name

Example:airdrop
phasestring

Comma-separated lifecycle phases. active = tasks open, can participate (POTENTIAL + CONFIRMED). claimable = eligible, can claim (SNAPSHOT + VERIFICATION + REWARD_AVAILABLE). completed = done (DISTRIBUTED). Defaults to active,claimable to show actionable airdrops.

Example:active
reward_type'airdrop' | 'points' | 'whitelist' | 'nft' | 'role' | 'ambassador'

Filter by reward type

Example:airdrop
task_type'social' | 'bounty-platforms' | 'testnet' | 'mainnet' | 'role' | 'form' | 'liquidity' | 'mint-nft' | 'game' | 'trading' | 'staking' | 'depin' | 'node' | 'ambassador' | 'hold' | 'check-wallet' | 'mint-domain' | 'predictions' | 'deploy'

Filter activities containing tasks of this type

Example:social
has_openboolean

Only return activities with currently OPEN tasks

Example:true
sort_by'total_raise' | 'xscore' | 'last_status_update'

Field to sort results by

Example:last_status_update
order'asc' | 'desc'

Sort order

Example:desc
limitinteger

Results per page

Example:20
offsetinteger

Pagination offset

include_tasksboolean

Include full task list per activity

Example:true

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://example.com/schemas/DataResponseAirdropSearchItem.json"
}

Changes

No recorded changes to this operation across all 12 revisions of this API.