2fansAPI docs

Quickstart: your first pay-per-view link

View as Markdown

Get a key, check it, pick content from the vault, create a drop and find out when it sells.

A drop is a paid bundle of vault items with its own checkout page. This guide goes from a new account to a pay-per-view link you can send to a buyer. Prefer to let your AI do the typing? Use AI setup.

  1. 1Get a key

    Sign up at 2fans.io and complete creator verification, since uploads need an approved ID check. Upload at least one item to your vault, then open Vault → API Connect, press Generate new key and pick Other to make a Personal key. There's no approval step. It starts with dpfn_.

    Keep it in an environment variable, and never paste it into a shared chat.

    Shell
    export DROPFANS_API_KEY="dpfn_..."

  2. 2Check the key

    Call GET /me. If username is the account you expected, authentication works. kycStatus shows where the ID check stands, and key.tier shows which rate limit the key runs at.

    curl
    curl "https://www.dropfans.io/api/external/v1/me" \
  -H "Authorization: Bearer $DROPFANS_API_KEY"
    Node
    const res = await fetch('https://www.dropfans.io/api/external/v1/me', {
  headers: { Authorization: 'Bearer ' + process.env.DROPFANS_API_KEY },
});
console.log(await res.json());
    Python
    import os, requests

HEADERS = {"Authorization": f"Bearer {os.environ['DROPFANS_API_KEY']}"}
res = requests.get("https://www.dropfans.io/api/external/v1/me", headers=HEADERS)
print(res.json()["username"])
    Response
    {
  "id": "cmawq81x40001lb04xyz12abc",
  "username": "ava",
  "name": "Ava",
  "image": "https://cdn.dropfans.io/ava/avatar.jpg",
  "accountType": "CREATOR",
  "kycStatus": "approved",
  "key": { "name": "Personal", "app": null, "tier": "personal" }
}

  3. 3Pick content from the vault

    GET /vault returns approved items by default. Pass includePending=true to see items still in review. Uploads take real minutes to clear, so poll instead of assuming they are ready.

    curl
    curl "https://www.dropfans.io/api/external/v1/vault?limit=10" \
  -H "Authorization: Bearer $DROPFANS_API_KEY"
    Node
    const res = await fetch('https://www.dropfans.io/api/external/v1/vault?limit=10', {
  headers: { Authorization: 'Bearer ' + process.env.DROPFANS_API_KEY },
});
const { items } = await res.json();
const ids = items.slice(0, 3).map((i) => i.id);
    Python
    import os, requests

HEADERS = {"Authorization": f"Bearer {os.environ['DROPFANS_API_KEY']}"}
res = requests.get("https://www.dropfans.io/api/external/v1/vault?limit=10", headers=HEADERS)
ids = [i["id"] for i in res.json()["items"][:3]]

  4. 4Create the drop

    Price is in USD: 0 for free, otherwise $5 to $750. A drop takes up to 10 vault items. Use 0 while testing, because there is no sandbox or test card. A drop built from approved items is approved straight away.

    curl
    curl -X POST "https://www.dropfans.io/api/external/v1/drops" \
  -H "Authorization: Bearer $DROPFANS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "name": "Beach set",
      "price": 15,
      "vaultItemIds": [
        "VAULT_ITEM_A",
        "VAULT_ITEM_B"
      ]
    }'
    Node
    const res = await fetch('https://www.dropfans.io/api/external/v1/drops', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer ' + process.env.DROPFANS_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Beach set",
    "price": 15,
    "vaultItemIds": [
      "VAULT_ITEM_A",
      "VAULT_ITEM_B"
    ]
  }),
});
console.log(await res.json());
    Python
    import os, requests

res = requests.post(
    "https://www.dropfans.io/api/external/v1/drops",
    headers={"Authorization": f"Bearer {os.environ['DROPFANS_API_KEY']}"},
    json={
      "name": "Beach set",
      "price": 15,
      "vaultItemIds": [
        "VAULT_ITEM_A",
        "VAULT_ITEM_B"
      ]
    },
)
print(res.json())
    Response
    {
  "productId": "...",
  "buyUrl": "https://www.dropfans.io/buy/...",
  "mediaCount": 2
}

  5. 5Send the link

    The buyUrl works anywhere a URL goes: a DM, a chat, a link in bio. Buyers need no account. To tell buyers apart, add your own reference to the link. See Sell on Telegram and in chats.

    Link
    https://www.dropfans.io/buy/{productId}?m={yourReference}

  6. 6Find out it sold

    POST /drops/check-status takes up to 200 product ids and returns the ones that sold. Unsold ids are simply missing. A refunded sale still reports paid: true here, so use GET /earnings for money and approved-app webhooks for instant updates.

    curl
    curl -X POST "https://www.dropfans.io/api/external/v1/drops/check-status" \
  -H "Authorization: Bearer $DROPFANS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "productIds": [
        "PRODUCT_ID"
      ]
    }'
    Node
    const res = await fetch('https://www.dropfans.io/api/external/v1/drops/check-status', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer ' + process.env.DROPFANS_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "productIds": [
      "PRODUCT_ID"
    ]
  }),
});
console.log(await res.json());
    Python
    import os, requests

res = requests.post(
    "https://www.dropfans.io/api/external/v1/drops/check-status",
    headers={"Authorization": f"Bearer {os.environ['DROPFANS_API_KEY']}"},
    json={
      "productIds": [
        "PRODUCT_ID"
      ]
    },
)
print(res.json())

Next

Sell on Telegram and in chatsCreate one drop, give each fan a personal pay-per-view link and match every sale back to the right chat.WebhooksSet one signed endpoint for your app and react to sales, refunds, subscriptions, payouts and ID-check results.Connect other people’s creatorsGet your app approved, send creators a connect link, then validate and store the key they give you.

Last updated 2026-11-02