OF-Scraper
  • Welcome
  • Requirements
  • Install
    • Pre-Install Guides
      • Linux
      • Windows
      • Mac
    • PIPX Install
    • PIP Install
    • Binary Releases
    • Docker
    • Release Info
    • Managing Multiple Python Versions
  • Getting Started and Settings
    • Config Options
      • Config Location
      • General Options
      • File Output Options
        • Placeholders
        • Responsetype Placeholders
      • Download Options
        • Download Toggles
        • Media Filtering Options
        • Advanced Download Options
      • Setting metadata path
      • Binaries Options
      • CDM Options
      • Performance Options
        • Values to Pick
      • Script Options
      • Advanced config options
        • Changing Const Values
        • Mediatype overwrites
    • Depreciated Options
    • Auth
    • Controlling Output/Logs
    • Migrating from Digitalcriminal's script
  • Using the Scraper
    • Using Prompts
      • Old Menu
      • Page 2
    • Username selection or Fuzzy Search
    • Basic Automation with command-line
      • Basic Actions
        • Liking/Unliking Post
        • Downloading Content
          • Downloading Text Files
          • Downloading Purchases From Deleted Models
        • Multiple Actions
      • Model Filtering/Sorting
        • Price Filtering/Sort
      • Advanced Args
      • Scripting tips
      • Enable label scan
    • Recipes
      • Adding Proxy
      • Redownload Deleted Downloads
  • Content Check Modes
    • Table Columns
    • Table Management
      • Pre 3.10.7 filtering
  • Scraping Individual Posts or Media
  • Metadata
    • Schema
    • Creating Metadata
    • Metadata location
  • CDM Setup
    • CDM issues
  • FAQ/Common Issues
    • Page 1
  • Command Reference
    • Shared Options
      • General Program Options
        • Program Options
        • Logging Options
        • Filename Modification Options
        • Media Filters Options
        • Download Options
        • Advanced Program Options
      • Shared Scrape and Metadata Check Mode Options
        • User List Filter Options
          • Advanced User Filters
        • User Selection Options
        • Model Sorting & Processing Options
        • Content Options
        • Automation Options
        • Advanced Search & Processing Options
    • Main Scraper Options
    • Metadata Check Mode Options
    • Content Check Modes Options
    • Manual Mode Options
  • Request Change to Doc
  • Testing
Powered by GitBook
On this page
  • Targeting Content
  • -o, --posts [argument]
  • -t, --text [argument]
  • -la, --like-area [argument]
  • -da, --download-area [argument]
  • Filtering Content
  • -sk, --skip-timed
  • -ms, --mass-skip
  • -mm, --mass-msg
  • -ok, --only-timed
  • -ft, --filter [argument]
  • -nf, --neg-filter [argument]
  • -to, --protected-only
  • -no, --normal-only
  • -lb, --label
  • -pd, --post-id [argument]
  • -tls, --timeline-strict
  • AD Filter
  • -ba, --block-ads
  • -nf, --neg-filter [argument]
  • Date Range
  • -be, --before [argument]
  • -af, --after [argument]
  • Other Options
  • -e, --force-all
  • -fl,--force-like
  • -eq, --force-model-unique
  • -sp, --scrape-paid
  • -it, --item-sort [argument]
  • -xc ,--max-count [argument]
  1. Command Reference
  2. Shared Options
  3. Shared Scrape and Metadata Check Mode Options

Content Options

This section outlines various options for specifying content targets, actions, and filters within the program.

Targeting Content

-o, --posts [argument]

  • Specify the type of content to target for actions (like, unlike, download).

  • Possible choices: highlights, all, archived, messages, timeline, pinned, stories, purchased, profile, labels.

  • Defaults: to None.

-t, --text [argument]

  • Specify the type of content to target for text download

  • Note: This only has an effect on action download

  • Possible choices: highlights, all, archived, messages, timeline, pinned, stories, purchased, profile, labels.

  • Defaults: to None

-la, --like-area [argument]

  • Define the area for like/unlike actions (overrides --posts).

  • Possible choices: all, archived, timeline, pinned, stories, labels.

  • Defaults: to None.

-da, --download-area [argument]

  • Specify the area for download actions (overrides --posts).

  • Possible choices: highlights, all, archived, messages, timeline, pinned, stories, purchased, profile, labels.

  • Defaults to None.

Filtering Content

-sk, --skip-timed

  • Skips temporary posts (commonly used for promotions).

-ms, --mass-skip

  • Filters downloads to include only those labeled as mass messages.

-mm, --mass-msg

  • Excludes downloads marked as mass messages.

-ok, --only-timed

  • Downloads only temporary posts (mostly used for promotions).

-ft, --filter [argument]

  • Filter posts using a provided regular expression pattern.

  • Case-sensitive if uppercase characters are included.

  • Posts matching the pattern are included.

  • Defaults: to ".*" (matches all posts).

-nf, --neg-filter [argument]

  • Filter posts to exclude based on a regular expression pattern.

  • Case-sensitive if uppercase characters are included.

  • Posts matching the pattern are excluded.

  • Defaults: to None (no exclusion)

-to, --protected-only

  • Restricts downloads to content requiring decryption.

-no, --normal-only

  • Restricts downloads to content that does not require decryption.

-lb, --label

  • Scrape content with specific labels.

  • Defaults: to None (no specific label).

-pd, --post-id [argument]

  • Filters content based on post ID

  • Arguments: One or more comma-separated (",") post IDs. You can also provide URLs containing a valid post ID

  • Defaults: None

  • Note: In certain situation this will allow direct search of content, namely for timeline and message related posts and if the number is less then 10

  • Note: you can also use manual if you want to process post for multiple users

-tls, --timeline-strict

  • Filters timeline to only include non-pinned and non-archived posts

  • Default: False

AD Filter

-ba, --block-ads

  • Filter posts with regex to block posts with common words for advertisements

  • Regex :

Note: This is passed as a raw string when being used by python

"(#(?:ad|ads|AD|advertising|sponsored|promotion)|trial|discount|exclusive\s+offer|giveaway|limited\s+time|\Buser\s+promo|shoutout|endorsement)"

  • Defaults: None

-nf, --neg-filter [argument]

  • Filter posts to exclude based on a regular expression pattern.

  • Case-sensitive if uppercase characters are included.

  • Posts matching the pattern are excluded.

  • Defaults: to None (no exclusion)

Date Range

-be, --before [argument]

  • Process posts on or before a specified date (format: Month/Day/Year).

-af, --after [argument]

  • Process posts on or after a specified date (format: Month/Day/Year).

Other Options

-e, --force-all

  • Downloads all files regardless of database presence.

  • Defaults: to False

-fl,--force-like

  • Like posts regardless of status in cache

  • Defaults: to False

-eq, --force-model-unique

  • Downloads files only if not present for the current model

  • Defaults: to False.

-sp, --scrape-paid

  • Scrapes the entire paid page for content (can be time-consuming).

  • Defaults: to False.

-it, --item-sort [argument]

  • Defines the order for processing media sort order before actions.

  • Uses default action sorting if None.

  • Defaults are:

    • Date for likes/unlikes (always)

    • Date for normal downloader

    • Shuffled for batch downlooader

  • Possible choices:

    • random: Randomize order

    • text-asc: Sort by post text in ascending order

    • text-desc: Sort by post text in descending order

    • date-asc: Sort by media date in ascending order

    • date-desc: Sort by media date in descending order

-xc ,--max-count [argument]

  • Sets the maximum number of posts to like or download.

  • Defaults: to None (no limit).

PreviousModel Sorting & Processing OptionsNextAutomation Options

Last updated 8 months ago

LogoSelecting Posts | OF-Scraper
Valid Date Inputs