Pinterest Image Scraper & Downloader

Overview

This Apify actor scrapes and downloads images from Pinterest pins. It extracts multiple image resolutions and comprehensive metadata for each provided URL, outputting structured JSON data. It's designed for batch processing of Pinterest content.

Key Features

• Bulk Image Download: Processes multiple Pinterest pin URLs in a single run.
• Multiple Resolutions: Fetches up to 8 different image size variants per pin, from thumbnails to the original quality.
• Complete Metadata: Extracts detailed information including pin IDs, descriptions, timestamps, and engagement stats (likes, saves, comments).
• User & Board Data: Captures uploader, original creator, current pinner, and board information.
• Robust Processing: Includes URL validation, error handling with success/failure status per URL, and direct CDN access for downloads.

How to Use

1. Provide a list of Pinterest URLs in the actor's input.
2. Start the actor. It will process each URL, download available images, and gather metadata.
3. Retrieve the structured JSON output from the dataset, which includes download links and all scraped data.

Input

Configure the actor by passing a JSON object with an array of Pinterest URLs. Both pin.it short links and full pinterest.com/pin/ URLs are accepted.

{
  "media_urls": [
    { "url": "https://pin.it/6XXeT5pA6" },
    { "url": "https://www.pinterest.com/pin/99079260547630498/" }
  ]
}

Output

The actor returns an array of JSON objects, one for each processed input URL. Each object contains a status flag, the original URL, and a data object with all scraped details.

Core Status Fields:
* success: Boolean indicating if the scrape was successful.
* url: The original URL that was processed.
* error: null if successful, otherwise contains an error message.

Example data object structure:

{
  "id": "432838214205733278",
  "type": "image",
  "description": "Pin description text...",
  "seo_title": "SEO title...",
  "created_at": "Sat, 10 May 2025 04:07:03 +0000",
  "stats": {
    "repin_count": 1,
    "like_count": 2,
    "total_saves": 3
  },
  "uploader": { ... },
  "board": {
    "name": "Board Name",
    "privacy": "public"
  },
  "downloads": {
    "image": [
      {
        "size": "orig",
        "url": "https://i.pinimg.com/originals/e0/9b/d9/e09bd9...jpg",
        "width": 1080,
        "height": 1927
      }
      // ... more size variants
    ]
  }
}

Key data fields include:
* Content Info: id, type, description, seo_title, created_at.
* Engagement: stats object with counts for repins, likes, comments, and saves.
* User Data: uploader, original_creator, and current_pinner objects.
* Board Data: board object with name, ID, and privacy setting.
* Downloads: The downloads.image array contains URLs, dimensions, and size labels for all available image versions.