From the project folder run this command in your terminal:
pip install -r requirements.txt
Open:
config.json
[auth]
Fill in the following:
{"app-token":"your_token"}{"auth_id":"your_auth_id"}{"auth_hash":"your_auth_hash"}{"user-agent":"your_user-agent"}
Sess token is optional but does help with authing into your account.
{"sess":"your_user-agent"}
Go to www.onlyfans.com and login, open the network debugger, then check the image below on how to get app-token, auth_id, auth_hash and user-agent
Open:
config.json
[settings]
directory:
Default = ""
Leave directory empty if you want files to be downloaded in the script folder.
If you're going to fill, please remember to use forward ("/") slashes only.
file_name_format:
Default = "{file_name}.{ext}"
{username} = The account's username
{text} = The post's text
{date} = The post's date
{file_name} = The media's file name
{ext} = The media's file extension
Example: {date}/{text}-{file_name}.{ext}
Warning: It's important to keep a unique identifier next to .{ext}. By default it's {file_name}.
text_length:
Default = ""
Ideal = "50"
Max = "240"
When you use {text} in file_name_format, a limit of how many characters can be set by inputting a number.
auto_site_choice:
Default = ""
When you start the script you will be presented with the following scraping choices:
onlyfans = onlyfans
justforfans = justforfans
You can automatically choose what you want to scrape if you add it in the config file.
auto_choice:
Default = ""
When you start the script you will be presented with the following scraping choices:
Everything = "a"
Images = "b"
Videos = "c"
Audios = "d"
You can automatically choose what you want to scrape if you add it in the config file.
|NEW| auto_scrape_all:
Default = false
If set to true, the script will scrape all the names.
export_type:
Default = "json"
a = "json"
b = "csv"
You can export an archive to different formats.
overwrite_files:
Default = true
If set to false, any file with the same name won't be downloaded.
date_format:
Default = "%d-%m-%Y"
If you live in the USA and you want to use the incorrect format, use the following:
"%m-%d-%Y"
multithreading:
Default = true
If set to false, you will download files 1 by 1. (If you don't have fast internet, may god help you.)
I'd reccomend leaving it set to true.
infinite_loop:
Default = true
If set to false, the script will run once and ask you to input anything to continue.
boards:
Default = []
Example = ["s", "gif"]
Input boards names that you want to automatically scrape.
ignored_keywords:
Default = []
Example = ["ignore", "me"]
Any words you input, the script will ignore any content that contains these words.
-l
This will only scrape and export links to a json file without downloading any files.
You can import the following functions from modules.onlyfans These functions will go through various changes, so each commit may break your code.
create_session(user_agent, auth_id, auth_hash, app_token)
This function will try to create and return a authenticated session along with your subscriber count.
get_subscriptions(session, app_token, subscriber_count)
This function will return an array of all the accounts you're subscribed too.
start_datascraper(session, app_token, username)
This function will scrape the username/link you pass.
The function will return true if scrape has finished and false if something went wrong.
Before troubleshooting, make sure you're using Python 3.8.
Error: Access Denied / Auth Loop
Make sure your cookies and user-agent are correct.
AttributeError: type object 'datetime.datetime' has no attribute 'fromisoformat'
Only works with Python 3.7 and above.
I'm getting authed into the wrong account
Enjoy the free content.