Giveaway Verification API: Check Retweets, Replies, Follows

import requests
import os

API_KEY = os.environ["XCROP_API_KEY"]
HEADERS = {"Authorization": "Bearer " + API_KEY}
BASE = "https://xcrop.io/api/v2"
TWEET_ID = "1893045621038174208"

# Check retweet
rt = requests.get(
    BASE + "/tweets/" + TWEET_ID + "/check-retweet",
    headers=HEADERS,
    params={"username": "alice_crypto"}
).json()
print("Retweeted:", rt["data"]["retweeted"])

# Check reply with 3 friend tags required
reply = requests.get(
    BASE + "/tweets/" + TWEET_ID + "/check-reply",
    headers=HEADERS,
    params={"username": "alice_crypto", "min_tags": 3}
).json()
print("Replied:", reply["data"]["replied"])
print("Tags met:", reply["data"]["tags_met"])

# Check follow relationship
follow = requests.get(
    BASE + "/users/check-follow",
    headers=HEADERS,
    params={"source": "alice_crypto", "target": "your_project"}
).json()
print("Follows you:", follow["data"]["source_follows_target"])

import requests
import time
import os
import json

API_KEY = os.environ["XCROP_API_KEY"]
HEADERS = {"Authorization": "Bearer " + API_KEY}
BASE = "https://xcrop.io/api/v2"

TWEET_ID = "1893045621038174208"
PROJECT_USERNAME = "your_project"
MIN_TAGS = 3

# List of participants (from your entry collection system)
participants = ["alice_crypto", "bob_defi", "charlie_nft"]  # ... thousands more

def verify_participant(username):
    """Check all conditions for a single participant."""
    result = {"username": username, "passed": False}

    # 1. Check retweet
    rt = requests.get(
        BASE + "/tweets/" + TWEET_ID + "/check-retweet",
        headers=HEADERS,
        params={"username": username}
    ).json()
    result["retweeted"] = rt["data"]["retweeted"]

    # 2. Check reply with friend tags
    reply = requests.get(
        BASE + "/tweets/" + TWEET_ID + "/check-reply",
        headers=HEADERS,
        params={"username": username, "min_tags": MIN_TAGS}
    ).json()
    result["replied"] = reply["data"]["replied"]
    result["tags_met"] = reply["data"].get("tags_met", False)

    # 3. Check follow
    follow = requests.get(
        BASE + "/users/check-follow",
        headers=HEADERS,
        params={"source": username, "target": PROJECT_USERNAME}
    ).json()
    result["follows"] = follow["data"]["source_follows_target"]

    # All conditions met?
    result["passed"] = (
        result["retweeted"]
        and result["replied"]
        and result["tags_met"]
        and result["follows"]
    )

    return result

# Verify all participants
verified = []
for i, user in enumerate(participants):
    try:
        result = verify_participant(user)
        verified.append(result)
        status = "PASS" if result["passed"] else "FAIL"
        print("[" + str(i + 1) + "/" + str(len(participants)) + "] @" + user + ": " + status)
    except Exception as e:
        print("[" + str(i + 1) + "] @" + user + ": ERROR - " + str(e))
    time.sleep(0.1)  # Be gentle with rate limits

# Results
winners = [r for r in verified if r["passed"]]
print("\nTotal checked:", len(verified))
print("Qualified:", len(winners))
print("Disqualified:", len(verified) - len(winners))

# Save results
with open("airdrop_results.json", "w") as f:
    json.dump({"winners": winners, "all": verified}, f, indent=2)

# Require at least 3 friend tags in the reply
response = requests.get(
    BASE + "/tweets/" + TWEET_ID + "/check-reply",
    headers=HEADERS,
    params={"username": "alice_crypto", "min_tags": 3}
).json()

data = response["data"]
print("Replied:", data["replied"])
print("Tags required:", data["tags_required"])  # 3
print("Tags found:", data["tags_found"])         # 4
print("Tags met:", data["tags_met"])             # True

// Run this in your form handler on the server. Calling XCROP from the browser would expose your API key.
async function checkWhitelistTasks(handle) {
  const headers = { Authorization: "Bearer " + process.env.XCROP_API_KEY };
  const base = "https://xcrop.io/api/v2";

  const [follow, retweet, reply] = await Promise.all([
    fetch(base + "/users/check-follow?source=" + handle + "&target=your_project", { headers }).then(r => r.json()),
    fetch(base + "/tweets/" + TWEET_ID + "/check-retweet?username=" + handle, { headers }).then(r => r.json()),
    fetch(base + "/tweets/" + TWEET_ID + "/check-reply?username=" + handle + "&min_tags=2", { headers }).then(r => r.json()),
  ]);

  // Report each task separately so the user knows what to fix.
  return {
    follows: follow.data.source_follows_target,
    retweeted: retweet.data.retweeted,
    replied: reply.data.verified, // replied AND met min_tags
  };
}

const API_KEY = process.env.XCROP_API_KEY;
const BASE = "https://xcrop.io/api/v2";
const TWEET_ID = "1893045621038174208";

async function checkInteractions(username) {
  const headers = { Authorization: "Bearer " + API_KEY };

  const [retweet, reply, relationship] = await Promise.all([
    fetch(BASE + "/tweets/" + TWEET_ID + "/check-retweet?username=" + username, { headers }).then(r => r.json()),
    fetch(BASE + "/tweets/" + TWEET_ID + "/check-reply?username=" + username + "&min_tags=3", { headers }).then(r => r.json()),
    fetch(BASE + "/users/check-follow?source=" + username + "&target=your_project", { headers }).then(r => r.json()),
  ]);

  return {
    username,
    retweeted: retweet.data.retweeted,
    replied: reply.data.replied,
    tags_met: reply.data.tags_met,
    follows: relationship.data.source_follows_target,
    qualified: retweet.data.retweeted && reply.data.replied && reply.data.tags_met && relationship.data.source_follows_target,
  };
}

// Verify participants in parallel (batches of 10)
async function verifyAll(participants) {
  const results = [];
  for (let i = 0; i < participants.length; i += 10) {
    const batch = participants.slice(i, i + 10);
    const batchResults = await Promise.all(batch.map(checkInteractions));
    results.push(...batchResults);
    console.log("Checked " + results.length + "/" + participants.length);
  }
  return results;
}