Posts
List Posts
Retrieve the post history for a specific account.
Get a list of posts for an account.
https://v1.apifansly.com
GET
/api/fansly/{account_id}/posts
Get Started
All requests to the Fansly API require an API Key. See the Authentication page for details.
Path Parameters
account_id*
stringThe unique identifier for the connected account.
curl -X GET "https://v1.apifansly.com/api/fansly/{account_id}/posts" \
-H "x-api-key: YOUR_API_KEY"fetch("https://v1.apifansly.com/api/fansly/{account_id}/posts", {
method: "GET",
headers: {
"x-api-key": "YOUR_API_KEY"
}
})import requests
url = "https://v1.apifansly.com/api/fansly/{account_id}/posts"
headers = {
"x-api-key": "YOUR_API_KEY"
}
response = requests.get(url, headers=headers)
print(response.json())import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://v1.apifansly.com/api/fansly/{account_id}/posts"))
.header("x-api-key", "YOUR_API_KEY")
.GET()
.build();
client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
.thenApply(HttpResponse::body)
.thenAccept(System.out::println)
.join();using System.Net.Http;
using System.Threading.Tasks;
var client = new HttpClient();
client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");
var response = await client.GetAsync("https://v1.apifansly.com/api/fansly/{account_id}/posts");
var responseString = await response.Content.ReadAsStringAsync();
Console.WriteLine(responseString);package main
import (
"fmt"
"io/ioutil"
"net/http"
)
func main() {
url := "https://v1.apifansly.com/api/fansly/{account_id}/posts"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Set("x-api-key", "YOUR_API_KEY")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}Response
{
"statusCode": 200,
"message": "Success",
"data": {
"status_code": 200,
"data": {
"success": true,
"response": {
"posts": [
{
"id": "8741xxxxxxxxxxxxxx",
"accountId": "8654xxxxxxxxxxxxxx",
"content": "Sample post content here...",
"fypFlags": 0,
"inReplyTo": null,
"inReplyToRoot": null,
"createdAt": 1769904856,
"expiresAt": null,
"attachments": [],
"likeCount": 0,
"timelineReadPermissionFlags": [],
"mediaLikeCount": 0,
"totalTipAmount": 0,
"attachmentTipAmount": 0,
"accountMentions": []
}
],
"aggregatedPosts": [],
"accountMediaBundles": [],
"accountMedia": [],
"accounts": [
{
"id": "8654xxxxxxxxxxxxxx",
"email": "creator@example.com",
"username": "creator_handle",
"displayName": "Creator Name",
"flags": 18,
"version": 3,
"createdAt": 1767823687000,
"followCount": 4,
"subscriberCount": 0,
"postLikes": 1,
"timelineStats": {
"accountId": "8654xxxxxxxxxxxxxx",
"imageCount": 0,
"videoCount": 0,
"bundleCount": 0,
"bundleImageCount": 0,
"bundleVideoCount": 0,
"fetchedAt": 1769978369637
},
"statusId": 1,
"lastSeenAt": 1769904954000,
"accountMediaLikes": 0,
"hasMainWall": true,
"walls": [
{
"id": "8681xxxxxxxxxxxxxx",
"accountId": "8654xxxxxxxxxxxxxx",
"pos": 0,
"name": "Posts",
"description": "",
"private": 0,
"metadata": "",
"defaultWall": true,
"mainWall": true
}
],
"earningsWallet": {
"id": -1,
"accountId": "8654xxxxxxxxxxxxxx",
"balance": 0,
"type": 2
},
"about": "Sample biography text for the creator...",
"location": "",
"subscriptionTiers": [
{
"id": "8701xxxxxxxxxxxxxx",
"accountId": "8654xxxxxxxxxxxxxx",
"name": "Subscription",
"price": 5000,
"subscriptionBenefits": [],
"plans": [
{
"id": "8701xxxxxxxxxxxxxx",
"status": 1,
"billingCycle": 30,
"price": 5000
}
]
}
],
"avatar": {
"id": "8654xxxxxxxxxxxxxx",
"mimetype": "image/jpeg",
"location": "/8654xxxxxxxxxxxxxx/8654xxxxxxxxxxxxxx.jpeg",
"variants": [
{
"id": "8654xxxxxxxxxxxxxx",
"mimetype": "image/jpeg",
"location": "/8654xxxxxxxxxxxxxx/8654xxxxxxxxxxxxxx.jpeg",
"locations": [
{
"locationId": "1",
"location": "https://cdn3.fansly.com/8654xxxxxxxxxxxxxx/8654xxxxxxxxxxxxxx.jpeg?ngsw-bypass=true&Expires=xxxx&Key-Pair-Id=xxxx&Signature=xxxx"
}
]
}
]
}
}
]
}
}
},
"timestamp": "2026-02-01T01:23:48.999Z"
}Response Body
| Field | Type | Description |
|---|---|---|
statusCode | number | The HTTP status code of the response (e.g., 200) |
message | string | A human-readable message about the result |
data | object | The main response payload |
├─ status_code | number | The internal status code of the Fansly operation |
└─ data | object | Nested data container |
└─ response | object | Container for the post data |
├─ posts | array | A list of post objects |
│ ├─ id | string | Unique identifier for the post |
│ ├─ content | string | The text content of the post |
│ ├─ createdAt | number | Unix timestamp of creation |
│ ├─ likeCount | number | Total number of likes |
│ ├─ fypFlags | number | Flags indicating FYP status |
│ └─ totalTipAmount | number | Total tip amount for the post |
└─ accounts | array | Account metadata related to the posts |
├─ id | string | Unique identifier for the account |
├─ username | string | The account's handle |
├─ displayName | string | The account's display name |
├─ email | string | The account's email (obfuscated in examples) |
├─ followCount | number | Number of followers |
├─ walls | array | List of content walls for the account |
└─ subscriptionTiers | array | Available subscription levels |
timestamp | string | The ISO 8601 timestamp of generation |