{
  "openapi": "3.0.1",
  "info": {
    "title": "Crypto Airdrops Scraper - Active & Upcoming Token Airdrops",
    "description": "Scrape active, upcoming and claimable crypto airdrops with project name, token ticker, status, reward actions, eligibility requirements, key dates, official website and social links. Filter by status and chain. Export to JSON, CSV or Excel.",
    "version": "0.1",
    "x-build-id": "Quz4vh7M77dlHmcB9"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapers_lat~crypto-airdrops-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapers_lat-crypto-airdrops-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/scrapers_lat~crypto-airdrops-scraper/runs": {
      "post": {
        "operationId": "runs-sync-scrapers_lat-crypto-airdrops-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/scrapers_lat~crypto-airdrops-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-scrapers_lat-crypto-airdrops-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "statuses": {
            "title": "Airdrop Statuses",
            "type": "array",
            "description": "One run can cover several airdrop states. Choose any of: active (live airdrops open now), confirmed (officially confirmed token airdrops), upcoming (speculative / potential retroactive airdrops), claimable (tokens you can claim now). Add as many as you want.",
            "default": [
              "active",
              "upcoming"
            ],
            "items": {
              "type": "string"
            }
          },
          "chains": {
            "title": "Chains Filter",
            "type": "array",
            "description": "Optional. Keep only airdrops whose detected blockchain matches one of these, for example [\"ethereum\", \"solana\", \"base\"]. Leave empty to include every chain.",
            "items": {
              "type": "string"
            }
          },
          "airdropTypes": {
            "title": "Airdrop Types Filter",
            "type": "array",
            "description": "Optional. Keep only airdrops of these participation types: \"task\" (social / quest actions), \"retroactive\" (on-chain usage: trade / bridge / mint / testnet), \"holder\" (hold or stake a token). Leave empty for all types.",
            "items": {
              "type": "string"
            }
          },
          "excludeKyc": {
            "title": "Exclude KYC Airdrops",
            "type": "boolean",
            "description": "Optional. When enabled, drop airdrops that require identity verification (KYC).",
            "default": false
          },
          "minHotness": {
            "title": "Minimum Hotness Score",
            "type": "integer",
            "description": "Optional. Keep only airdrops whose community hotness/temperature score is at least this value."
          },
          "search": {
            "title": "Keyword Search",
            "type": "string",
            "description": "Optional. Case-insensitive keyword to match against project name, token, category and eligibility text."
          },
          "includeDetails": {
            "title": "Enrich With Airdrop Details",
            "type": "boolean",
            "description": "When enabled (default), each airdrop is enriched with token ticker, description, key dates, official website and social links from its detail page. Disable for a faster, lighter run with just the listing fields.",
            "default": true
          },
          "maxAirdrops": {
            "title": "Max Airdrops To Scrape",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "Maximum number of airdrops to collect across all selected statuses."
          },
          "withAiSummary": {
            "title": "AI airdrop summary (paid add-on)",
            "type": "boolean",
            "description": "Add a plain-English AI summary of each airdrop (project, how to qualify, potential reward). Opt-in, billed per enriched record; requires a paid Apify plan.",
            "default": false
          },
          "withAiRisk": {
            "title": "AI risk / red-flag analysis (paid add-on)",
            "type": "boolean",
            "description": "AI risk assessment flagging airdrop red flags (unconfirmed token, KYC/data harvesting, vague eligibility, effort vs reward, scam signals). Opt-in, billed per enriched record.",
            "default": false
          },
          "withAiTags": {
            "title": "AI topic tags (paid add-on)",
            "type": "boolean",
            "description": "Generate concise topic tags (chain, sector, activity type) for each airdrop via AI. Opt-in, billed per enriched record.",
            "default": false
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}