FMFansMetric API

User Lists

Bulk Add Users To List

Adds many fans to a single custom list in one round trip. Prefer this over calling Add User to List in a loop — one OF call instead of N. Requires permission api_user_lists_bulk_add_members.

https://public-api.fansmetric.com
POST/v1/{account_id}/user-lists/{list_id}/users
Bearer

Authorization

default
AuthorizationBearer <token>

Send your FansMetric API key as a Bearer token in the Authorization header.

In: header

Path Parameters

  • account_id*integer

    OnlyFans numeric account ID.

  • list_id*integer

    Custom list ID.

Request Body

application/json
  • user_ids*array

    Array of OnlyFans user IDs (integer) to add. Must contain at least one entry.

Response Fields

  • dataobject

    Empty success object when every user was added. If some adds fail (e.g. user deleted or blocked), data.errors is an object keyed by list ID with per-user-ID error arrays.

  • _meta._credits.usedinteger

    Credits consumed by this request (currently always 1).

  • _meta._rate_limits.limit_minuteinteger

    Maximum requests per minute for the organization.

  • _meta._rate_limits.remaining_minuteinteger

    Remaining requests in the current minute window.

  • _meta._rate_limits.limit_dayinteger

    Maximum requests per day for the organization.

  • _meta._rate_limits.remaining_dayinteger

    Remaining requests in the current day window.

curl --request POST "https://public-api.fansmetric.com/v1/100000001/user-lists/sample_list_id/users" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{ "user_ids": [12345678, 87654321, 11223344] }'

Response

200
{
"data":{
"errors":{
"47382":{
"999999999":[
0:"User not found"
]
}
}
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}

Previous

Get User List

Next

Clear User List