Tags
Discover Media by Tag
Get media associated with a specific tag. This endpoint is optimized for discovery and returns relevant content based on the provided tag.
https://v1.apifansly.com
GET
/api/fansly/{accountId}/discover/tags/{tagId}/media
Get Started
All requests to the Fansly API require an API Key. See the Authentication page for details.
Request Details
curl -X GET "https://v1.apifansly.com/api/fansly/{accountId}/discover/tags/{tagId}/media" \
-H "x-api-key: YOUR_API_KEY"fetch("https://v1.apifansly.com/api/fansly/{accountId}/discover/tags/{tagId}/media", {
method: "GET",
headers: {
"x-api-key": "YOUR_API_KEY"
}
})
.then(response => response.json())
.then(data => console.log(data));import requests
url = "https://v1.apifansly.com/api/fansly/{accountId}/discover/tags/{tagId}/media"
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/{accountId}/discover/tags/{tagId}/media"))
.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/{accountId}/discover/tags/{tagId}/media");
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/{accountId}/discover/tags/{tagId}/media"
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))
}Parameters
The query typically involves either nextCursor or before/after numbers.
accountId*
stringThe unique identifier for the connected account, retrieved from your Dashboard.
tagId*
stringThe unique identifier of the tag.
nextCursor ?
stringThe cursor to fetch subsequent pages (recommended over before/after).
Response
{
"statusCode": 200,
"message": "Success",
"data": {
"status_code": 200,
"data": {
"success": true,
"response": {
"mediaOfferSuggestions": [
{
"id": "unique_media_offer_suggestion_identifier",
"accountId": "unique_account_identifier",
"mediaOfferId": "media_offer_identifier",
"mediaOfferType": "media_offer_type_integer",
"mediaOfferBundleId": null,
"mediaId": "media_identifier",
"mediaType": "media_type_integer",
"previewId": null,
"correlationId": "correlation_identifier",
"tags": [],
"postTags": [
{
"id": "unique_tag_identifier",
"tag": "sample_tag_name",
"label": "tag_label_string",
"description": "tag_description_string",
"viewCount": "number_of_views",
"postCount": "number_of_posts",
"flags": "integer_flag_value",
"createdAt": "timestamp_in_milliseconds"
}
],
"valid": true
}
],
"aggregationData": {
"accounts": [
{
"id": "unique_account_identifier",
"username": "account_username",
"displayName": "display_name_string",
"flags": "account_flags_integer",
"version": "version_number",
"createdAt": "timestamp_in_milliseconds",
"followCount": "number_of_followers",
"subscriberCount": "number_of_subscribers",
"permissions": {
"accountPermissionFlags": {
"flags": "permission_flags_integer"
}
},
"timelineStats": {
"accountId": "unique_account_identifier",
"imageCount": "number_of_images",
"videoCount": "number_of_videos",
"bundleCount": "number_of_bundles",
"bundleImageCount": "number_of_bundle_images",
"bundleVideoCount": "number_of_bundle_videos",
"fetchedAt": "timestamp_in_milliseconds"
},
"mediaStoryState": {
"accountId": "unique_account_identifier",
"status": "status_integer",
"storyCount": "story_count_integer",
"version": "version_number",
"createdAt": "timestamp_in_milliseconds",
"updatedAt": "timestamp_in_milliseconds",
"hasActiveStories": false
},
"postLikes": "number_of_post_likes",
"statusId": "status_identifier",
"lastSeenAt": "timestamp_in_milliseconds",
"accountMediaLikes": "number_of_media_likes",
"profileAccessFlags": "profile_access_flags_integer",
"profileFlags": "profile_flags_integer",
"about": "profile_about_text",
"location": "location_string",
"profileSocials": [
{
"providerId": "provider_identifier",
"handle": "social_handle"
}
],
"profileBadges": [],
"pinnedPosts": [
{
"postId": "post_identifier",
"accountId": "unique_account_identifier",
"pos": "position_index",
"wallId": "wall_identifier",
"createdAt": "timestamp_in_milliseconds"
}
],
"subscriptionTiers": [
{
"id": "tier_identifier",
"accountId": "unique_account_identifier",
"name": "tier_name",
"color": "hex_color_code",
"pos": "position_index",
"price": "price_integer",
"maxSubscribers": "max_subscribers_integer",
"subscriptionBenefits": [
"benefit_description_string"
],
"includedTierIds": [],
"plans": [
{
"id": "plan_identifier",
"status": "status_integer",
"billingCycle": "billing_cycle_days",
"price": "price_integer",
"useAmounts": "use_amounts_integer",
"promos": [
{
"id": "promo_identifier",
"status": "status_integer",
"price": "promo_price_integer",
"duration": "duration_days",
"maxUses": "max_uses_integer",
"maxUsesBefore": "timestamp_in_milliseconds",
"newSubscribersOnly": "boolean_integer_flag",
"description": "promo_description",
"startsAt": "timestamp_in_milliseconds",
"endsAt": "timestamp_in_milliseconds",
"uses": "number_of_uses"
}
],
"uses": "number_of_uses"
}
]
}
],
"avatar": {
"id": "avatar_identifier",
"type": "avatar_type_integer",
"status": "status_integer",
"accountId": "unique_account_identifier",
"mimetype": "image_mimetype",
"flags": "avatar_flags_integer",
"location": "avatar_url_location",
"width": "image_width",
"height": "image_height",
"metadata": "metadata_json_string",
"updatedAt": "timestamp_in_seconds",
"createdAt": "timestamp_in_seconds",
"variants": [
{
"id": "variant_identifier",
"type": "variant_type_integer",
"status": "status_integer",
"mimetype": "image_mimetype",
"flags": "flags_integer",
"location": "variant_url_location",
"width": "image_width",
"height": "image_height",
"metadata": "metadata_json_string",
"updatedAt": "timestamp_in_seconds",
"locations": [
{
"locationId": "location_identifier",
"location": "signed_cdn_url"
}
]
}
],
"variantHash": {},
"locations": [
{
"locationId": "location_identifier",
"location": "signed_cdn_url"
}
]
},
"banner": {
"id": "banner_identifier",
"type": "banner_type_integer",
"status": "status_integer",
"accountId": "unique_account_identifier",
"mimetype": "image_mimetype",
"flags": "flags_integer",
"location": "banner_url_location",
"width": "image_width",
"height": "image_height",
"metadata": "metadata_json_string",
"updatedAt": "timestamp_in_seconds",
"createdAt": "timestamp_in_seconds",
"variants": [
{
"id": "variant_identifier",
"type": "variant_type_integer",
"status": "status_integer",
"mimetype": "image_mimetype",
"flags": "flags_integer",
"location": "variant_url_location",
"width": "image_width",
"height": "image_height",
"metadata": "metadata_json_string",
"updatedAt": "timestamp_in_seconds",
"locations": [
{
"locationId": "location_identifier",
"location": "signed_cdn_url"
}
]
}
],
"variantHash": {},
"locations": [
{
"locationId": "location_identifier",
"location": "signed_cdn_url"
}
]
},
"walls": [
{
"id": "wall_identifier",
"accountId": "unique_account_identifier",
"pos": "position_index",
"name": "wall_name",
"description": "wall_description",
"private": "privacy_integer_flag",
"metadata": "metadata_string",
"defaultWall": true,
"mainWall": true
}
],
"hasMainWall": true,
"streaming": {
"accountId": "unique_account_identifier",
"channel": null,
"enabled": true
},
"profileAccess": true
}
]
}
}
},
"nextCursor": "next_page_cursor"
},
"timestamp": "2026-04-09T18:05:51.000Z"
}