Skip to main content

Scrape user data from Goodreads

Project description

Goodreads Icon

Goodreads User Scraper

Scrape Goodreads User Data: Profile, Book Shelves, Books, Authors

Version  Downloads  Build 

Contents

Usage

Using pip:

pip install goodreads-user-scraper
goodreads-user-scraper --user_id <your id> --output_dir goodreads-data

Using pipx:

pipx run goodreads-user-scraper --user_id <your id> --output_dir goodreads-data

Arguments

--user_id

  • Description: The user whose data should be scraped. Find your user id using these directions.
  • Required: Yes

--output_dir

  • Description: The directory where all scraped data will be output.
  • Required: No
  • Default: goodreads-data

--skip_user_info

  • Description: Whether the script should skip scraping user information.
  • Required: No
  • Default: False

--skip_shelves

  • Description: Whether the script should skip scraping shelves.
  • Required: No
  • Default: False

--skip_authors

  • Description: Whether the script should skip scraping authors.
  • Required: No
  • Default: False

Troubleshooting

Ensure that your profile is viewable by anyone:

  1. Navigate to the Goodreads Account Settings page
  2. Click on the Settings tab
  3. In the Privacy section, under the Who Can View My Profile question, select "anyone"

Development

  1. Clone the GitHub repository

    git clone https://github.com/YashTotale/goodreads-user-scraper.git
    
  2. Run the install script

    sh scripts/install.sh
    
  3. Make changes

  4. Run the test script

    sh scripts/test.sh
    

Publishing

  1. Create .env

    TWINE_USERNAME=<foo>
    TWINE_PASSWORD=<bar>
    
  2. Run the publish script

    sh scripts/publish.sh <patch|minor|major>
    

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

goodreads-user-scraper-1.2.4.tar.gz (7.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

goodreads_user_scraper-1.2.4-py3-none-any.whl (8.9 kB view details)

Uploaded Python 3

File details

Details for the file goodreads-user-scraper-1.2.4.tar.gz.

File metadata

  • Download URL: goodreads-user-scraper-1.2.4.tar.gz
  • Upload date:
  • Size: 7.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.10.9

File hashes

Hashes for goodreads-user-scraper-1.2.4.tar.gz
Algorithm Hash digest
SHA256 0b68b44349723222291641b87df771adee21ea27dd8fb1ce1f877c4eb2642e62
MD5 224922836f46436f6928c12fca6ac8d1
BLAKE2b-256 67c0b81084f671e2ebba4e02a54e7b41e23604f2e9034addc5cd4814f4f608c3

See more details on using hashes here.

File details

Details for the file goodreads_user_scraper-1.2.4-py3-none-any.whl.

File metadata

File hashes

Hashes for goodreads_user_scraper-1.2.4-py3-none-any.whl
Algorithm Hash digest
SHA256 18b7d86f21bfa0a6afb6d037485c72ad60450fc3545632900314fa84b3343d9a
MD5 77aee595cf830ced9610f01bebefbf1a
BLAKE2b-256 a731b4c8641818d7e8e78c5418a0184bd22e247498082219f4d035299fbb6598

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page