PinFetch - Pinterest Board Image Scraper & Downloader (Apify Actor)

Pinterest image scraper and downloader for Apify Actor, built with Python + Playwright. Collect high-quality Pinterest image URLs, download images automatically, and export downloaded files as ZIP.

Keywords: Pinterest scraper, Pinterest image downloader, Apify Pinterest Actor, Playwright scraper, Pinterest image URL extractor, bulk image download, Pinterest automation, pinimg originals

Description (for Apify SEO)

Scrape Pinterest image URLs with Playwright, download images in bulk, and export all downloaded files as a ZIP (IMAGES_ZIP). Includes per-image dataset output and run summary (OUTPUT) for reliable Pinterest data workflows.

What this Pinterest Scraper Actor does

• Opens a Pinterest page with Playwright.
• Scrolls the page and collects unique pinimg.com image URLs.
• Normalizes image URLs to original quality (/originals/).
• Downloads images to a local folder inside the Actor container.
• Pushes per-image status records to the dataset.
• Creates a ZIP of downloaded images and stores it in KV store as IMAGES_ZIP.
• Stores run summary in KV store key OUTPUT.

Input

Input is defined in .actor/input_schema.json.

• url (string, required): Pinterest profile/board/pin URL to scrape.
• max_scroll (integer): Maximum number of scroll rounds.
• max_no_new (integer): Stop after N rounds with no new image URLs.
• max_images (integer, optional): Stop early when collected image count reaches this limit.
• scroll_delay_sec (number): Delay between scroll rounds.
• save_dir (string): Directory for downloaded files in container.
• request_timeout_sec (integer): HTTP timeout per image request.
• download_delay_sec (number): Delay between each download.
• headless (boolean): Run Chromium in headless mode.

Output

1) Dataset (image URL results)

Schema: .actor/dataset_schema.json

Each item includes:

• source_url
• image_url
• file_name
• status
• status_code
• error

2) Downloaded images ZIP

• KV key: IMAGES_ZIP
• Exposed by output schema in .actor/output_schema.json

3) Run summary (OUTPUT)

KV key: OUTPUT

Typical fields:

• source_url
• image_count
• downloaded_count
• save_dir
• zip_key
• zip_file_name
• zip_file_count

How to download ZIP from Apify Console

After the run is finished, open the run page (example):

• https://console.apify.com/actors/KiITVfqPpB73YtURf/runs/auVvwyqn3agMvVg7o#output

Then:

1. Go to Output section.
2. You will initially see Image URL dataset.
3. Click the dropdown (arrow-down icon).
4. Change selection to Downloaded images ZIP.
5. The ZIP download will start automatically (or a download link will appear).

If needed, download directly from KV record URL:

• https://api.apify.com/v2/key-value-stores/8LWpZk3wuuBpR0rRr/records/IMAGES_ZIP

Generic format:

• https://api.apify.com/v2/key-value-stores/<KEY_VALUE_STORE_ID>/records/IMAGES_ZIP

Run locally

$apify run

Deploy

apify login
apify push

Main code

• Runtime entrypoint: src/main.py
• Original reference logic: .mycode/pin.py