Read the #FAQ at the bottom of this page before submitting a issue.
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_sess_token"}
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
python StartDatascraper.py
Enter in inputs as prompted by console.
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.
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.
|NEW| ignore_unfollowed_accounts:
Default = ""
a = "all"
b = "paid"
c = "free"
This setting will not include any paid or free accounts that you've unfollowed in your subscription list.
Example: "ignore_unfollowed_accounts": "paid"
This choice will not include any unfollowed accounts that you've paid for.
-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.
I'm using Linux OS and something isn't working.
Script was built on Windows 10. If you're using Linux you can still submit an issue and I'll try my best to fix it.