Account
Get Accounts By IDs
Get detailed information for specific connected Fansly accounts by passing a comma-separated list of their accountIds.
https://v1.apifansly.com
GET
/api/fansly/accounts/by-ids
Note
The ids provided here must be the actual Fansly platform account IDs, not your internal platform account IDs.
Get Started
All requests to the Fansly API require an API Key. See the Authentication page for details.
Query Parameters
ids*
stringA comma-separated list of actual Fansly platform account IDs (e.g., `123456789,987654321`). Do not use our internal platform account IDs.
Authentication
curl -X GET "https://v1.apifansly.com/api/fansly/accounts/by-ids?ids=123456789,987654321" \
-H "x-api-key: YOUR_API_KEY"const params = new URLSearchParams({
ids: "123456789,987654321"
});
fetch(`https://v1.apifansly.com/api/fansly/accounts/by-ids?${params.toString()}`, {
method: "GET",
headers: {
"x-api-key": "YOUR_API_KEY"
}
})import requests
url = "https://v1.apifansly.com/api/fansly/accounts/by-ids"
headers = {"x-api-key": "YOUR_API_KEY"}
params = {"ids": "123456789,987654321"}
response = requests.get(url, headers=headers, params=params)
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/accounts/by-ids?ids=123456789,987654321"))
.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/accounts/by-ids?ids=123456789,987654321");
var responseString = await response.Content.ReadAsStringAsync();
Console.WriteLine(responseString);package main
import (
"fmt"
"net/http"
)
func main() {
url := "https://v1.apifansly.com/api/fansly/accounts/by-ids?ids=123456789,987654321"
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()
fmt.Println(resp.Status)
}Response
{
"statusCode": 200,
"message": "Success",
"data": {
"status_code": 200,
"data": {
"success": true,
"response": [
{
"id": "123456789012345678",
"username": "creator_handle",
"displayName": "Creator Name",
"flags": 18,
"version": 7,
"createdAt": 1695649241000,
"followCount": 7186,
"subscriberCount": 120,
"permissions": {
"accountPermissionFlags": { "flags": 0 }
},
"statusId": 1,
"lastSeenAt": 1774891196000,
"mediaStoryState": {
"accountId": "123456789012345678",
"status": 2,
"storyCount": 0,
"hasActiveStories": false
},
"timelineStats": {
"imageCount": 256,
"videoCount": 540,
"bundleCount": 27,
"fetchedAt": 1774937350282
},
"profileAccessFlags": 0,
"profileFlags": 0,
"about": "Welcome to my profile! I post daily content...",
"location": "Texas, USA",
"profileSocials": [
{ "providerId": "1", "handle": "creator_handle" }
],
"profileBadges": [
{
"badgeId": "865016804479627265",
"badgeType": 1002,
"badgeDescription": "Awarded for competing in the leaderboard.",
"metadata": "{...}"
}
],
"pinnedPosts": [
{ "postId": "881239718417670144", "pos": 0 }
],
"subscriptionTiers": [
{
"id": "562707018054381568",
"name": "Subscribe 🖤",
"price": 1499,
"plans": [
{
"id": "562707018083737600",
"billingCycle": 30,
"price": 1499,
"promos": [
{
"id": "855691179566579712",
"price": 700,
"description": "Flash sale!"
}
]
}
]
}
],
"accountMediaLikes": 13320,
"postLikes": 9287,
"avatar": {
"id": "861476184309919744",
"mimetype": "image/jpeg",
"location": "https://cdn3.fansly.com/avatar.jpeg",
"variants": [
{ "id": "v1", "location": "https://cdn3.fansly.com/avatar_v1.jpeg" }
]
},
"banner": {
"id": "858095528993374208",
"mimetype": "image/jpeg",
"location": "https://cdn3.fansly.com/banner.jpeg"
},
"hasMainWall": true,
"walls": [
{ "id": "785637371705040896", "name": "Posts", "mainWall": true }
],
"streaming": {
"enabled": true,
"channel": { "status": 2, "playbackUrl": "https://..." }
},
"profileAccess": true
}
]
}
},
"timestamp": "2026-03-30T17:20:59.476Z"
}{
"statusCode": 400,
"message": "ids query parameter is required",
"error": "Bad Request"
}Response Body
| Field | Type | Description |
|---|---|---|
statusCode | number | The HTTP status code of the internal response (e.g., 200) |
message | string | A human-readable message about the result |
data | object | The main response wrapper |
├─ status_code | number | The status code returned by the Fansly upstream API |
└─ data | object | The data returned by the Fansly upstream API |
├─ success | boolean | Whether the Fansly API request was successful |
└─ response | array | A list of detailed Fansly profile objects |
├─ id | string | The actual Fansly platform ID |
├─ username | string | Fansly account username |
├─ displayName | string | Fansly display name |
├─ about | string | Profile bio / about text |
├─ location | string | Profile location |
├─ followCount | number | Total number of followers |
├─ subscriberCount | number | Total number of subscribers |
├─ createdAt | number | Unix timestamp of account creation |
├─ lastSeenAt | number | Unix timestamp of last activity |
├─ timelineStats | object | Statistics for timeline content (counts for images, videos, etc.) |
├─ profileSocials | array | Linked social media handles |
├─ profileBadges | array | Badges awarded to the profile |
├─ pinnedPosts | array | List of posts pinned to the profile |
├─ subscriptionTiers | array | Detailed list of available subscription tiers, plans, and promos |
├─ avatar | object | Avatar media object with multiple resolution variants |
├─ banner | object | Banner media object with multiple resolution variants |
├─ walls | object | Profile walls (Posts, FYP, etc.) |
└─ streaming | object | Live streaming status and channel details |
timestamp | string | ISO 8601 timestamp of the response generation |