Skip to main content
pip install onlyfans-sdk

​
Quick Example

from onlyfans_sdk import OFAuthClient, account

client = OFAuthClient(api_key="your-api-key")

result = account.whoami(client)
print(result["id"], result["permissions"])

​
Details

Python
Packageonlyfans-sdk
Repositoryonlyfans-sdk-python
InitOFAuthClient()
ArchitectureFunctional modules + client
TypesPydantic v2 models
PaginationGenerators (for ... in)
Dependencieshttpx

​
Features

Pydantic Models

All responses are validated Pydantic v2 models with full type hints.

Generator Pagination

for ... in over any paginated list automatically.

Proxy Support

Call any OnlyFans endpoint directly through the OFAuth proxy.

Media Upload

Automatic chunking and progress callbacks.

​
Usage Examples

​
List subscribers

from onlyfans_sdk import access

subscribers = access.list_subscribers(
    client,
    connection_id="conn_xxx",
    limit=50
)

for sub in subscribers["data"]:
    print(sub["username"], sub["subscribed_at"])

​
Send a message

access.send_message(
    client,
    connection_id="conn_xxx",
    user_id="12345",
    text="Hello from OFAuth!"
)

​
Error handling

from onlyfans_sdk import OFAuthError

try:
    access.get_user(client, connection_id="conn_xxx", user_id="999")
except OFAuthError as e:
    print(e.status, e.code, e.message)