Webhooks are now available in the Fansly API Console! 🚀
Fansly API Logo
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*
string
A 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

FieldTypeDescription
statusCodenumberThe HTTP status code of the internal response (e.g., 200)
messagestringA human-readable message about the result
dataobjectThe main response wrapper
├─ status_codenumberThe status code returned by the Fansly upstream API
└─ dataobjectThe data returned by the Fansly upstream API
├─ successbooleanWhether the Fansly API request was successful
└─ responsearrayA list of detailed Fansly profile objects
├─ idstringThe actual Fansly platform ID
├─ usernamestringFansly account username
├─ displayNamestringFansly display name
├─ aboutstringProfile bio / about text
├─ locationstringProfile location
├─ followCountnumberTotal number of followers
├─ subscriberCountnumberTotal number of subscribers
├─ createdAtnumberUnix timestamp of account creation
├─ lastSeenAtnumberUnix timestamp of last activity
├─ timelineStatsobjectStatistics for timeline content (counts for images, videos, etc.)
├─ profileSocialsarrayLinked social media handles
├─ profileBadgesarrayBadges awarded to the profile
├─ pinnedPostsarrayList of posts pinned to the profile
├─ subscriptionTiersarrayDetailed list of available subscription tiers, plans, and promos
├─ avatarobjectAvatar media object with multiple resolution variants
├─ bannerobjectBanner media object with multiple resolution variants
├─ wallsobjectProfile walls (Posts, FYP, etc.)
└─ streamingobjectLive streaming status and channel details
timestampstringISO 8601 timestamp of the response generation

On this page