Publish a post to the For You feed

Rate limit: 5 posts per creator per rolling 24 hours. Bursts are fine — only the daily volume is capped. Exceeding it returns 429 with a Retry-After header.

Three shapes: • TEXT — caption only. • MEDIA — a gallery of 1-10 images from your vault, each free or paid. • DROP — attach an existing approved drop by productId.

For MEDIA, list your vault first (GET /api/external/vault) and use the id of an item whose moderationStatus is APPROVED to publish without waiting.

Everything posted here goes through exactly the same moderation as a post written in the web composer: captions run the prohibited-word filter, and media posts stay PENDING until every image clears the NSFW pipeline. You cannot use this API to bypass review.

{
  "caption": "im 5 min away, wyd?"
}

{
  "kind": "MEDIA",
  "caption": "rate my fit 1-10",
  "media": [
    {
      "vaultItemId": "clxv1a2b30001item",
      "isPaid": false,
      "order": 0
    }
  ]
}

{
  "kind": "MEDIA",
  "caption": "can i show you??",
  "scheduledAt": "2026-08-26T19:00:00Z",
  "media": [
    {
      "vaultItemId": "clxv1a2b30001item",
      "isPaid": false,
      "order": 0
    },
    {
      "vaultItemId": "clxv1a2b30002item",
      "isPaid": true,
      "price": 10,
      "order": 1
    }
  ]
}

{
  "id": "clxp0st000001feed",
  "status": "PENDING",
  "pending": true,
  "scheduledAt": null,
  "url": "https://www.dropfans.io/u/valeria"
}

curl -X POST "https://www.dropfans.io/api/external/posts" \
  -H "Authorization: Bearer $DROPFANS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "caption": "im 5 min away, wyd?"
}'

const res = await fetch(`https://www.dropfans.io/api/external/posts`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DROPFANS_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "caption": "im 5 min away, wyd?"
  }),
});
console.log(await res.json());

import os
import requests

res = requests.post(
    "https://www.dropfans.io/api/external/posts",
    headers={"Authorization": f"Bearer {os.environ['DROPFANS_API_KEY']}"},
    json={
        "caption": "im 5 min away, wyd?",
    },
)
print(res.json())