Airdrops APIairdrops.io ↗
Access airdrops.io data via API: browse latest, hot, and potential airdrops by category, get full project details, participation steps, token info, and live crypto prices.
What is the Airdrops API?
The airdrops.io API exposes 10 endpoints covering the full breadth of airdrop data published on airdrops.io, from paginated listing feeds to per-project detail pages. get_airdrop_details returns project name, status (confirmed or unconfirmed), blockchain platforms, token info, participation requirements, community temperature score, and estimated total value for any airdrop identified by its URL slug. Additional endpoints cover category filtering, keyword search, recently updated projects, and live prices for BTC, ETH, SOL, and other major assets.
curl -X GET 'https://api.parse.bot/scraper/9af824b0-75d0-4d52-bcd6-0e68141b30c8/get_latest_airdrops?page=1&sort=newest' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace airdrops-io-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Airdrops.io SDK — discover, filter, and drill into crypto airdrops."""
from parse_apis.airdrops_io_api import Airdrops, Sort, Category, AirdropNotFound
client = Airdrops()
# Browse hot airdrops ranked by community votes
for drop in client.airdropsummaries.hot(limit=5):
print(drop.name, drop.temperature, drop.requirements.telegram)
# Search for airdrops by keyword
result = client.airdropsummaries.search(query="bitcoin", limit=3).first()
if result:
print(result.name, result.slug, result.is_expired)
# Filter by category using the Category enum
for drop in client.airdropsummaries.by_category(category=Category.NFT, limit=3):
print(drop.name, drop.hot_vote_score)
# Drill into a specific airdrop for full details
airdrop = client.airdrops.get(slug="hyperliquid")
print(airdrop.name, airdrop.status, airdrop.temperature)
# Fetch participation requirements from the detail resource
info = airdrop.participation()
for step in info.participation_steps:
print(step)
# Typed error handling for missing airdrops
try:
client.airdrops.get(slug="nonexistent-project-xyz")
except AirdropNotFound as exc:
print(f"Not found: {exc.slug}")
# Check live crypto prices
for price in client.cryptoprices.list(limit=5):
print(price.ticker, price.usdprice, price.direction, price.percentage)
print("exercised: hot / search / by_category / get / participation / list prices")Retrieve the latest airdrops sorted by publish date or rating. Returns a paginated list of airdrop summaries. Each page contains up to 18 items.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| sort | string | Sort order for results. |
{
"type": "object",
"fields": {
"items": "array of AirdropSummary objects"
},
"sample": {
"data": {
"items": [
{
"id": "1828966",
"url": "https://airdrops.io/questflow/",
"logo": "https://airdrops.io/wp-content/uploads/2026/06/Questflow-logo.jpg",
"name": "Questflow",
"slug": "questflow",
"status": "",
"is_expired": false,
"description": "Create AI clone and refer users",
"is_featured": false,
"temperature": "28",
"is_confirmed": false,
"published_at": "20260610203119",
"requirements": {
"kyc": false,
"twitter": false,
"telegram": false
},
"hot_vote_score": "28"
}
]
},
"status": "success"
}
}About the Airdrops API
Listing and Category Endpoints
Four endpoints handle paginated airdrop lists, each returning up to 18 AirdropSummary objects per page. get_latest_airdrops accepts an optional sort parameter to order results by publish date or rating. get_hot_airdrops ranks results by hot_vote_score descending. get_potential_airdrops surfaces speculative retroactive opportunities. get_airdrops_by_category accepts a required category string — valid values include latest, hot, speculative, potential, nft, and telegram — and returns the matching subset. All four accept a page integer for pagination.
Detail and Token Endpoints
get_airdrop_details takes a slug matching the path segment of any airdrop URL on airdrops.io and returns a full record: logo URL, name, status, platforms array, token_info object (ticker, supply, chain), description, temperature, total_value, and a requirements array. For workflows that only need the token layer, get_airdrop_token_info returns just the key-value token details for the given slug — note that many early-stage projects return an empty object when that data has not yet been published. get_airdrop_participation_requirements returns both requirements and participation_steps arrays for the same slug, useful for building eligibility checkers without fetching the full detail record.
Search, Updates, and Prices
search_airdrops accepts a query string and returns matching summaries across both active and expired airdrops. get_updated_airdrops returns the homepage's "Updated Airdrops" section as a list of recently modified summaries — no parameters required. get_crypto_prices returns price objects for a fixed set of major cryptocurrencies (BTC, ETH, SOL, HYPE, XMR), each with usdprice, direction, and percentage change fields, reflecting the ticker data displayed on the site.
The Airdrops API is a managed, monitored endpoint for airdrops.io — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when airdrops.io changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official airdrops.io API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a personal airdrop dashboard that surfaces confirmed airdrops filtered by blockchain platform from
get_airdrop_details. - Automate alerts when new entries appear in
get_hot_airdropswith a vote score above a defined threshold. - Aggregate participation steps from
get_airdrop_participation_requirementsinto a task checklist for multiple active airdrops. - Track speculative retroactive opportunities by polling
get_potential_airdropsdaily and diffing results. - Enrich a DeFi research tool with live BTC, ETH, and SOL price direction signals from
get_crypto_prices. - Index airdrop content for full-text search by combining
search_airdropsresults with detailed token info fromget_airdrop_token_info. - Monitor the NFT airdrop category specifically by passing
nftto thecategoryparam ofget_airdrops_by_category.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does airdrops.io offer an official developer API?+
What does `get_airdrop_details` return, and how do I identify a specific airdrop?+
slug parameter — the path segment from the airdrop's URL on airdrops.io (for example, uniswap from airdrops.io/airdrop/uniswap). It returns the project logo, name, confirmation status, blockchain platforms, token details (ticker, supply, chain), description, community temperature score, estimated total value, and an array of participation requirements.Are expired or historical airdrops accessible through search?+
search_airdrops returns matches across both active and expired airdrops indexed on airdrops.io, so historical projects that match the query keyword will appear in results alongside current ones.