Mass Messages
List Mass Message Fan Lists
Returns fan lists available for targeting mass messages — built-in lists (fans, recent, following) plus custom lists. Requires permission api_mass_messages_list_fan_lists.
https://public-api.fansmetric.comGET/v1/{account_id}/mass-messages/lists
Bearer
Authorization
defaultAuthorizationBearer <token>Send your FansMetric API key as a Bearer token in the Authorization header.
In: header
Path Parameters
account_id*integerOnlyFans numeric account ID.
Query Parameters
limitintegerNumber per page. Default 10. Min 1, max 100.
offsetintegerPagination offset.
querystringCase-insensitive substring match against the list name. Omit to return all lists.
related_userstringOnlyFans numeric user ID. When set, results are restricted to lists that already contain that fan — handy for deduping before bulk-add.
curl --request GET "https://public-api.fansmetric.com/v1/acct_XXXXX/mass-messages/lists?limit=20&offset=0&query=creator" \
--header "Authorization: Bearer YOUR_API_KEY"Response
200{
"data":{
"list":[
0:{
"id":"fans"
"type":"fans"
"name":"All Subscribers"
"usersCount":5000
}
1:{
"id":"recent"
"type":"recent"
"name":"Recent"
"usersCount":150
}
2:{
"id":47382
"type":"custom"
"name":"VIP Fans"
"usersCount":50
}
]
"hasMore":true
}
"_pagination":{
"next_page":"/v1/100000001/mass-messages/lists?limit=10&offset=10"
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}