Airdrop Search

GET/gateway/v1/search/airdrop

Searches and filters airdrop opportunities.

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

Returns paginated results with optional task details.

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_typeenum<string>

Filter by reward type

Available options:airdroppointswhitelistnftroleambassador

Example: airdrop

task_typeenum<string>

Filter activities containing tasks of this type

Available options:socialbounty-platformstestnetmainnetroleformliquiditymint-nftgametradingstakingdepinnodeambassadorholdcheck-walletmint-domainpredictionsdeploy

Example: social

has_openboolean

Only return activities with currently OPEN tasks

Example: true

sort_byenum<string>

Field to sort results by

Available options:total_raisexscorelast_status_update

Example: last_status_update

orderenum<string>

Sort order

Available options:ascdesc

Example: desc

limitinteger

Results per page

Example: 20

offsetinteger

Pagination offset

Example: 0

include_tasksboolean

Include full task list per activity

Example: true

Airdrop Search

const options = {method: 'GET'};

fetch('https://api.asksurf.ai/gateway/v1/search/airdrop?q=airdrop&phase=active&reward_type=airdrop&task_type=social&has_open=true&sort_by=last_status_update&order=desc&limit=20&offset=0&include_tasks=true', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "$schema": "https://example.com/schemas/DataResponseAirdropSearchItem.json",
  "data": [
    {
      "coin_symbol": "<string>",
      "followers_count": 123,
      "last_status_update": 123,
      "logo_url": "<string>",
      "project_id": "<string>",
      "project_name": "<string>",
      "reward_date": 123,
      "reward_type": "<string>",
      "status": "<string>",
      "task_summary": {
        "open": 123,
        "total": 123,
        "types": []
      },
      "tasks": [
        {
          "blockchains": [],
          "close_date": 123,
          "cost": 123,
          "external_link": "<string>",
          "is_exclusive": true,
          "open_date": 123,
          "status": "<string>",
          "time_minutes": 123,
          "title": "<string>",
          "type": "<string>"
        }
      ],
      "total_raise": 123,
      "xscore": 123
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "empty_reason": "<string>",
    "has_more": true,
    "limit": 123,
    "offset": 123,
    "total": 123,
    "watermark": 123
  }
}