API reference

Check one post’s moderation status

One post, as a **bare object** (not wrapped). The polling endpoint after a PENDING create: check `status` and `live`.

View as MarkdownUpdated Aug 19, 2026

GET/api/external/posts/{id}

One post, as a bare object (not wrapped). The polling endpoint after a PENDING create: check status and live.

A sensible poll cadence is every 30–60 seconds while PENDING; media moderation usually resolves within minutes.

Authentication

Send the creator's API key as a bearer token: Authorization: Bearer dpfn_…. See Authentication & API keys.

Path parameters

Name	Type	Required	Description
`id`	string	Required	The post id.

Responses

200The post.

Name Type Description

id string Post id.

kind

string

Post shape. DROP is derived from productId at creation — it is not an accepted request value.

One of: TEXT, DROP, SUBSCRIPTION, COMMUNITY, MEDIA

caption string | null Post text. Null for caption-less media posts.

status

string

Moderation state. PENDING is normal for media posts and is not an error — poll until it becomes APPROVED.

One of: PENDING, APPROVED, REJECTED, FLAGGED

live boolean True only when the post is APPROVED and its publish time has passed.

scheduledAt

string | null

When the post is scheduled to go live, or null for immediate posts.

Format: date-time

publishedAt

string

Effective publish time.

Format: date-time

createdAt

string

Creation time.

Format: date-time

productId string | null The attached drop, for kind=DROP. Null otherwise.

likes integer Like count.

comments integer Comment count.

media

PostMedia[]

Media entries in display order. Empty for TEXT posts.

Show child attributes

`id`	string	Post-media row id.
`vaultItemId`	string	The source vault item.
`isPaid`	boolean	True for PPV items shown blurred until unlocked.
`order`	integer	Display position (0-based).
`type`	string	Media kind (image/video).

Example response

{
  "id": "clxp0st000001feed",
  "kind": "MEDIA",
  "caption": "rate my fit 1-10",
  "status": "APPROVED",
  "live": true,
  "scheduledAt": null,
  "publishedAt": "2026-08-18T19:00:00.000Z",
  "createdAt": "2026-08-18T18:59:40.000Z",
  "productId": null,
  "likes": 14,
  "comments": 3,
  "media": [
    {
      "id": "clxpm3d1a0001post",
      "vaultItemId": "clxv1a2b30001item",
      "isPaid": false,
      "order": 0,
      "type": "image"
    }
  ]
}

Errors

Status	Body	When
401	`{"error":"Unauthorized","code":"unauthorized"}`	Missing or invalid API key.
404	`{"error":"Post not found"}`	No such post on your account. Deliberately 404 (not 403) for another creator’s post — ids cannot be probed.

Rate limiting

Every response carries the X-RateLimit-Tier header and, on limited tiers, the per-minute and per-day trios — read X-RateLimit-Remaining and X-RateLimit-Reset instead of hardcoding limits. Details in Rate limits.

Code samples

curl "https://www.dropfans.io/api/external/posts/$POST_ID" \
  -H "Authorization: Bearer $DROPFANS_API_KEY"

const postId = '…'; // from an earlier response

const res = await fetch(`https://www.dropfans.io/api/external/posts/${postId}`, {
  headers: {
    Authorization: `Bearer ${process.env.DROPFANS_API_KEY}`,
  },
});
console.log(await res.json());

import os
import requests

post_id = "…"  # from an earlier response

res = requests.get(
    f"https://www.dropfans.io/api/external/posts/{post_id}",
    headers={"Authorization": f"Bearer {os.environ['DROPFANS_API_KEY']}"},
)
print(res.json())

← Previous

List your posts and their moderation status

Delete a post (or cancel a scheduled one)

Questions? [email protected]